mirror of
https://github.com/YunoHost/doc.git
synced 2024-09-03 20:06:26 +02:00
Update doc_writing_guide.md
Co-Authored-By: Allan Nordhøy <epost@anotheragency.no>
This commit is contained in:
parent
e4d94d8d80
commit
7d699f1279
1 changed files with 37 additions and 1 deletions
|
@ -1 +1,37 @@
|
|||
# Guide to writing documentation
|
||||
# Guide to writing application documentation
|
||||
|
||||
## Pages for user / administative documentation
|
||||
|
||||
Add a one-click installation button (like for example: https://yunohost.org/#/app_piwigo)
|
||||
|
||||
Classification of the application can be done using the available tags (genre, Git, management association, e-mails, etc.)
|
||||
|
||||
*/Find a suitable documentation license. Permissive or not? (CC BY_SA)/*
|
||||
|
||||
## Clarify the types of uses it has (special and general application (editorial choice)
|
||||
|
||||
+ For links to other languages, add (en)` for Egnlish, and so on.
|
||||
|
||||
### Things to include in application documentation
|
||||
|
||||
1. An index of what is included, without reiterating the full content of what is to be found in subsequent chapters.
|
||||
1. A one-click install button.
|
||||
1. A general presentation of the application and its function.
|
||||
1. A section detailing administration of the application.
|
||||
1. A further section on changes specific to YunoHost.
|
||||
1. A section about the desktop client (if applicable). Links to different third party applications (if they exist), (or a link to a list of applications [framalibre.org](https://framalibre.org)) or a link to a page that has to do with the different official applications (if applicable).
|
||||
+ A further section:
|
||||
- Links to the official website.
|
||||
- Links to the package in YunoHost.
|
||||
1. Documentation of any further uses (documentation of an application).
|
||||
|
||||
## Roadmap
|
||||
|
||||
1. Documentation of the applications.
|
||||
1. Document how the application operates in use (marked: work) level 8/7/6.
|
||||
1. Translate the documentation at-least into French and English.
|
||||
1. Send a PR to the repository of the app that details its documentation.
|
||||
|
||||
## Document an application
|
||||
|
||||
Do you need to detail how it works?
|
||||
|
|
Loading…
Add table
Reference in a new issue