doc/doc_writing_guide_fr.md

# Guide de rédaction de la documentation des applications

## Page de documentation utilisateurs·rices / administrateurs⋅rices

Ajouter un bouton installer en un clic (comme par exemple : https://yunohost.org/#/app_piwigo_fr) et un bouton sur le niveau d'intégration de l'application.

Classement des applications disponibles par tags (genre, Git, gestion associations, courriels, etc).

## Quelques usages types et d'ordre général (trame de rédaction)

 + Lorsqu'un lien renvoie vers une page qui n'est pas dans la langue de la page d'origine, il est d'usage d'ajouter `(en)`(Pour un lien qui pointe vers une page en anglais).
 + renommer les images dans l'ordre suivant :`nomapplication_descriptif.ext`

### Trame générale documentation applications

 1. Logo (dimension 80 pixels de hauteur) + titre de niveau 1.
 1. Bouton installer en un clic, Niveau d'intégration pour chaque type de processeur.
 1. Un index en tête de documentation avec renvoi vers l'ensemble des chapitres de la documentation.
 1. Une présentation générale de l'application et de sa fonction.
 2. Une partie configuration de l'application.
 1. Une partie administration de l'application.
 1. Une partie sur les limitations liées à YunoHost.
 1. Une partie sur les clients desktop (si il en existe). Lien vers différentes applications tierces si il en existe plusieurs (lien possible avec le catalogue d'applications [framalibre.org](https://framalibre.org)) ou un lien vers la page concernant les applications desktop si des applications officielles sont fournies.
 1. Une partie avec :
    - le lien vers le site officiel
    - le lien vers la documentation officielle
    - Les liens vers le package de YunoHost et issues

Trame pour la rédaction des pages de documentations : [ici](/app_writing_guide)

## Feuille de route

1. Documenter les applications.
   1. Documenter les applications au travail (marqué : work) niveau 8/7/6.
   1. Traduire la page de documentation à minima en français et en anglais.
   1. Faire une PR sur le dépôt de l'application concernée vers la page de documentation.
Update doc_writing_guide_fr.md Co-Authored-By: Allan Nordhøy <epost@anotheragency.no> 2020-04-01 11:12:46 +02:00			`# Guide de rédaction de la documentation des applications`
Add writing guide, git guide and markdown guide fr version final 2020-03-30 18:59:16 +02:00
Correction ortho 2020-04-26 02:08:43 +02:00			`## Page de documentation utilisateurs·rices / administrateurs⋅rices`
Add writing guide, git guide and markdown guide fr version final 2020-03-30 18:59:16 +02:00
Correction ortho 2020-04-26 02:08:43 +02:00			`Ajouter un bouton installer en un clic (comme par exemple : https://yunohost.org/#/app_piwigo_fr) et un bouton sur le niveau d'intégration de l'application.`
Update and various corrections 2020-04-17 11:48:51 +02:00
Fix errors 2020-04-17 13:04:15 +02:00			`Classement des applications disponibles par tags (genre, Git, gestion associations, courriels, etc).`
Add writing guide, git guide and markdown guide fr version final 2020-03-30 18:59:16 +02:00
Correction ortho 2020-04-26 02:08:43 +02:00			`## Quelques usages types et d'ordre général (trame de rédaction)`
Add writing guide, git guide and markdown guide fr version final 2020-03-30 18:59:16 +02:00
Correction ortho 2020-04-26 02:08:43 +02:00			+ Lorsqu'un lien renvoie vers une page qui n'est pas dans la langue de la page d'origine, il est d'usage d'ajouter `(en)`(Pour un lien qui pointe vers une page en anglais).
Add informations in writing guide + example with app Pi Hole 2020-04-02 13:35:00 +02:00			+ renommer les images dans l'ordre suivant :`nomapplication_descriptif.ext`
Add writing guide, git guide and markdown guide fr version final 2020-03-30 18:59:16 +02:00
Correction ortho 2020-04-26 02:08:43 +02:00			`### Trame générale documentation applications`
Add writing guide, git guide and markdown guide fr version final 2020-03-30 18:59:16 +02:00
Correction ortho 2020-04-26 02:08:43 +02:00			`1. Logo (dimension 80 pixels de hauteur) + titre de niveau 1.`
			`1. Bouton installer en un clic, Niveau d'intégration pour chaque type de processeur.`
			`1. Un index en tête de documentation avec renvoi vers l'ensemble des chapitres de la documentation.`
			`1. Une présentation générale de l'application et de sa fonction.`
			`2. Une partie configuration de l'application.`
Add writing guide, git guide and markdown guide fr version final 2020-03-30 18:59:16 +02:00			`1. Une partie administration de l'application.`
Correction ortho 2020-04-26 02:08:43 +02:00			`1. Une partie sur les limitations liées à YunoHost.`
			`1. Une partie sur les clients desktop (si il en existe). Lien vers différentes applications tierces si il en existe plusieurs (lien possible avec le catalogue d'applications [framalibre.org](https://framalibre.org)) ou un lien vers la page concernant les applications desktop si des applications officielles sont fournies.`
Add informations in writing guide + example with app Pi Hole 2020-04-02 13:35:00 +02:00			`1. Une partie avec :`
Update and various corrections 2020-04-17 11:48:51 +02:00			`- le lien vers le site officiel`
Correction ortho 2020-04-26 02:08:43 +02:00			`- le lien vers la documentation officielle`
Update and various corrections 2020-04-17 11:48:51 +02:00			`- Les liens vers le package de YunoHost et issues`
Add writing guide, git guide and markdown guide fr version final 2020-03-30 18:59:16 +02:00
Update and various corrections 2020-04-17 11:48:51 +02:00			`Trame pour la rédaction des pages de documentations : [ici](/app_writing_guide)`
Adding a framework for writing documentation 2020-04-03 12:12:03 +02:00
Add writing guide, git guide and markdown guide fr version final 2020-03-30 18:59:16 +02:00			`## Feuille de route`

			`1. Documenter les applications.`
			`1. Documenter les applications au travail (marqué : work) niveau 8/7/6.`
			`1. Traduire la page de documentation à minima en français et en anglais.`
Correction ortho 2020-04-26 02:08:43 +02:00			`1. Faire une PR sur le dépôt de l'application concernée vers la page de documentation.`