Cambios en "Improve the process for contributing to documentation"
Título (English)
- -Clarify the process for contributing to documentation
- +Improve the process for contributing to documentation
Descripción (English)
-
-
Clarify the process for contributing to documentation
-
+
The documentation is currently organized on Antora, a tool allowing multi repository doc website in Ascii doc.
The Decidim doc is organized like this:
Understand
It has several issues, mainly:
It mixes different types of documentation in a same place: Developers, administrators, users, researchers, etc.
The documentation source is scattered in 2 different places: on decidim/decidim and on decidim/documentation
It's hard for non developers to contribute to it, even for small contributions (like fixing a typo)
The multilanguage is not easy to use, as it has to go through the Crowdin project (implying the knowledge of another tool)