https://bugs.documentfoundation.org/show_bug.cgi?id=148621

--- Comment #1 from Dan Dascalescu <[email protected]> ---
Re. 6 - some more documentation is split at documentation.libreoffice.org,

such as this useful cheat sheet -
https://documentation.libreoffice.org/assets/Uploads/Documentation/en/MACROS/RefCards/LibOBasic-3-Calc-Flat-A4-EN-v111.pdf

Centralizing and cross-linking these disparate places would be a step forward,
but a clean solution would be to bring all the documentation in *one* place, in
an easily editable format *stored on GitHub*, using a modern documentation
publishing framework like https://readthedocs.org/ or https://docusaurus.io/,
or at least a Wiki like MediaWiki.

I suspect a chunk of documentation might be in code comments and needs to be
extracted out, so I'm not making specific recommendations for a documentation
platform.

But I do want to urge using GitHub (or at least GitLab) as the VCS, because
whether you like it or not, GitHub does make it easy to edit documentation in a
browser, and has the highest number of registered developers familiar with its
interface and with an account already set up. This is key for encouraging
"drive-by" documentation fixes and contributions.

Note that MDN, one of the largest and most often accessed open-source
documentation platforms ever, has also switched to GitHub for hosting the
content and accepting contributions -
https://hacks.mozilla.org/2020/10/mdn-web-docs-evolves-lowdown-on-the-upcoming-new-platform/

-- 
You are receiving this mail because:
You are the assignee for the bug.

Reply via email to