Re: [qubes-devel] Should we migrate the documentation to another platform?

2021-09-30 Thread unman
On Tue, Sep 28, 2021 at 02:59:03PM +0200, Wojtek Porczyk wrote: > On Mon, Sep 27, 2021 at 04:46:28AM -0700, Andrew David Wong wrote: > > RTD: > > RTD, apart from sphinx, also supports mkdocs, though I've never used it. > > > + Built-in release-specific doc support. > > + Built-in localization sup

Re: [qubes-devel] Should we migrate the documentation to another platform?

2021-09-28 Thread Wojtek Porczyk
-BEGIN PGP SIGNED MESSAGE- Hash: SHA512 On Mon, Sep 27, 2021 at 04:46:28AM -0700, Andrew David Wong wrote: > RTD: RTD, apart from sphinx, also supports mkdocs, though I've never used it. > + Built-in release-specific doc support. > + Built-in localization support. > + Supports Git for ve

Re: [qubes-devel] Should we migrate the documentation to another platform?

2021-09-27 Thread Konstantin Ryabitsev
On Mon, Sep 27, 2021 at 04:46:28AM -0700, Andrew David Wong wrote: > Wiki: > + Familiar to almost everyone thanks to Wikipedia and specialized wikis. > + Easy for users to contribute. > + Built-in version control and history. > + Includes search functionality. > + Even more widespread use throughou

[qubes-devel] Should we migrate the documentation to another platform?

2021-09-27 Thread Andrew David Wong
## Summary Currently, the Qubes documentation is written in plain text Markdown files, version controlled with Git, rendered using Jekyll, and hosted from GitHub Pages. This setup has served us well over the years, but as the demands on the documentation have grown, it has become increasingly