doc/doc_writing_guide_fr.md

# Guide de rédaction de la documentation des applications

## Pages de documentations utilisateurs.trices / administrateurs⋅trices

Ajouter un bouton installer en un clique (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.).

*/Définition d'une license de diffusion de la documentation, mais laquelle ? Permissive ou non (CC BY-SA)/*

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

 + Lorsqu'un lien renvoi 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éral documentation applications

 1. Logo (dimension 80 pixels de hauteurs) + titre de niveau 1.
 1. Bouton installer en un clique, Niveau d'intégration pour chaque type de processeur.
 1. Un index en tête de documentations avec renvois vers l'ensemble des chapitres de la documentation.
 1. Une présentation général 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 limitation liés à YunoHost.
 1. Une partie sur les client desktop (si il en existe). Lien vers différentes applications tierces si il en existe plusieurs (lien possible avec le catalgue d'applications [framalibre.org](https://framalibre.org))  ou un lien vers la page concernant les applications desktop si des applications officiels sont fournis.
 1. Une partie avec :
    - le lien vers le site officiel
    - le lien vers la documentation
    - 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é 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
			`## Pages de documentations utilisateurs.trices / administrateurs⋅trices`

Update and various corrections 2020-04-17 11:48:51 +02:00			`Ajouter un bouton installer en un clique (comme par exemple : https://yunohost.org/#/app_piwigo_fr) et un bouton sur le niveau d'intégration de l'application.`

Add writing guide, git guide and markdown guide fr version final 2020-03-30 18:59:16 +02:00
			`Classement des applications disponibles par tags (genre, Git, gestion associations, courriels, etc.).`

Update doc_writing_guide_fr.md Co-Authored-By: Allan Nordhøy <epost@anotheragency.no> 2020-04-01 11:07:20 +02:00			`/Définition d'une license de diffusion de la documentation, mais laquelle ? Permissive ou non (CC BY-SA)/`
Add writing guide, git guide and markdown guide fr version final 2020-03-30 18:59:16 +02:00
			`## Quelques usages types et d'ordres général (trame de rédaction)`

			+ Lorsqu'un lien renvoi 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
			`### Trame général documentation applications`

Add informations in writing guide + example with app Pi Hole 2020-04-02 13:35:00 +02:00			`1. Logo (dimension 80 pixels de hauteurs) + titre de niveau 1.`
Update and various corrections 2020-04-17 11:48:51 +02:00			`1. Bouton installer en un clique, Niveau d'intégration pour chaque type de processeur.`
Add writing guide, git guide and markdown guide fr version final 2020-03-30 18:59:16 +02:00			`1. Un index en tête de documentations avec renvois vers l'ensemble des chapitres de la documentation.`
			`1. Une présentation général de l'application et de sa fonction.`
Update and various corrections 2020-04-17 11:48:51 +02:00			`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.`
Update and various corrections 2020-04-17 11:48:51 +02:00			`1. Une partie sur les limitation liés à YunoHost.`
Update doc_writing_guide_fr.md Co-Authored-By: Allan Nordhøy <epost@anotheragency.no> 2020-04-01 11:14:45 +02:00			`1. Une partie sur les client desktop (si il en existe). Lien vers différentes applications tierces si il en existe plusieurs (lien possible avec le catalgue d'applications [framalibre.org](https://framalibre.org)) ou un lien vers la page concernant les applications desktop si des applications officiels sont fournis.`
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`
			`- le lien vers la documentation`
			`- 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.`
Update doc_writing_guide_fr.md Co-Authored-By: Allan Nordhøy <epost@anotheragency.no> 2020-04-01 11:15:03 +02:00			`1. Faire une PR sur le dépôt de l'application concerné vers la page de documentation.`