“How-to” guides for Qubes.
Also don’t forgot to check out the Qubes OS documentation. And if you’d like to contribute to it, it is accessible on Github here and review the contributing guidelines.
Start a new discussion via email (no account required) by sending a message to:
guides at forum.qubes-os.org
List-ID for this category is guides.user-support.forum.qubes-os.org
It would be helpful to have a link to this documentation in the left pane of the official Qubes documentation. (Or is there already one - at least, I did not find it?)
Suggestion to replace this content with something like the following:
The official documentation of Qubes OS (or core documentation) is the main source of documentation about Qubes OS specific software. The Community guides category is part of the external documentation. It can document how to use a different kind of software in Qubes OS (i.e. a VPN), some personal preferences, non-standard setups, scripts and so on.
If your guide is about something that should be in the official documentation instead, consider editing the documentation instead of posting a community guide.
See: Core vs. external documentation
It is recommended (but not required) that you follow the official guidelines while writing a community guide:
- Writing guidelines
- Do not duplicate documentation
- Markdown style guide and conventions (some of them are specific to the website)
Community guides are wiki posts that can (and should) be updated by the whole community, not only the author.
The Discourse forum interface, allows you to “insert a table of content” in the guide. It will insert the following line in the content:
<div data-theme-toc="true"> </div>
Optional sentence at the end:
If you have followed a guide, you can reply to the topic, to let others know if it was successful or not.
It feels like a social media post and I’m wondering if it would be useful to encourage that kind of feedback?