-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512
Thanks for your feedback! There's been a lot of discussion about this
both on the mailing lists and GitHub (which you can search for, if
interested) and internally over the years.
One of the main reasons we decided to migrate from the TracWiki system
to the current system is your Con 2. Since Qubes is a
security-oriented operating system, it's significantly more important
than in the case of other OSes that we safeguard the legitimacy of the
documentation and that users have a way of verifying the integrity and
authenticity of all content and changes. People who need a secure
operating system may be more likely to be the targets of attacks, and
the documentation can be used as an attack vector (MITM,
misinformation, etc.).
The principal shortcomings you identify in the current system are not,
IMHO, inherent limitations of the GitHub/Jekyll platform. Rather, I
think they're symptoms of the fact that the documentation is
maintained almost entirely by a motley collection of volunteer
efforts. In other words, there is no one person whose job it is to
make sure that all the documentation is kept up-to-date;
well-organized; edited for content, style, and diction; consistently
formatted; etc. To do it right is a major undertaking, larger than
many realize (like writing a book, then continuously revising it --
forever).
[Personal note: My part-time role as community manager includes only a
subset of these documentation tasks, and even then only as a low
priority when things are slow. I still do as much as I can on top of
that in my dwindling free time, but, unfortunately, I also have to
work for a living outside of Qubes. I'd love to work on all of this
full time someday and raise the scope and quality of our documentation
to the level of other major OSes, but right now the project needs to
prioritize its limited budget on development. (As a user of Qubes who
depends on it daily for security, I fully support this!)]
- --
Andrew David Wong (Axon)
Community Manager, Qubes OS
https://www.qubes-os.org
-----BEGIN PGP SIGNATURE-----
iQIcBAEBCgAGBQJXXcrcAAoJENtN07w5UDAwMM4P/1agI5eCY1EGDK63rfoq2q/Z
uyx1lP0O3dbRztLeTyKcq7hLEiaU9KTj65kp8CsUBq/wfVKcgwBHXekCFxbvdrz4
0NnVTAZMb+UpvKwzRt8RnltSPN0MUWV0ovjPf2JAX/fwvJk6ZkvRym5Fug7oYbP4
G85FknnsgMDlrXPKV/hM2RoQy1iCGF2u4c2o1K0dwcYJZHhoSHr/EsUL5+mLhdxL
5vYEfOmykwa/KW5uTamr20otapN/RgW+iQsMvHo8DiO23IcSEXYfO9GsBDhX87BF
JhXC7c/T7sWeApyNR2f1byjVVFuiGjN/ldx8eH4qgvQt2sU16TsS2WDFoIllinXy
Ef9JAtiAEYWpmG5O0E6y+by6pEk4elJXBOuxvgblWmKLX9TKozmAlVbdySVRS4/U
DYeH64fetP5OS5kIFaPlGlo9ONugRGs4aY0+ev2QCVLpix8gd2fgVhXVd/j8GQU/
eR6r4x/UG3qGYpBwlxJOfClSWrYIgwmH0uYbBxHkStWYMktpu7V+S7f5UwBFlqri
zSs4nG49QmcZYeO2Ovl07JsxMlo9fx9pXhif7mEcvstJfRbJX3/9GEy2mK6cIao4
QzGlMJm6plYVR9ip3qyoJ7FOxXkvq3q6w59iRYKPSrpTU2hbf5XDV2TWCblMs730
18pIoSHhmtCWD4CTla71
=WXrm
-----END PGP SIGNATURE-----