Announcement | Qubes-community Project has been Migrated to the Forum

We’re pleased to announce that the content of the qubes-community project has been migrated to the forum. The guides are now in the Community Guides category, and can easily be browsed with Discourse’s doc plugin interface, in addition to the standard search.

Rationale behind the migration

The forum has become the place that the qubes-community project was originally meant to be - and much more. In a recent discussion between Qubes OS “documentation” people - the forum admins/mods, the official qubes-doc maintainers, and qubes-community admins - it was agreed that it would make sense to migrate most of the qubes-community documentation to the forum’s “Guides” section.

The main reasons for doing so are:

  • visibility /and as a corollary, avoiding duplication/: there is a significant amount of posts in the forum in which people are asking questions (or providing solutions) that are documented on qubes-community - that for some reason they didn’t find.
  • ease of use/contribution: admittedly, Discourse makes it a lot easier to contribute than GitHub/git.
  • avoiding document “rot”: with wiki-type guides, an easy-to-use platform, and easy-to-find resources, we hope that people will contribute more frequently to existing guides, even if that means simply posting a short but helpful comment.

Maintaining the documentation’s high level of quality on a more “open” platform

Content quality: we will employ tags to signal high quality reviewed content and selected guides will likely be linked from an index page on the project’s website. Nevertheless the good will be stored in the same place as the questionable and we’ll have to work out ways of signalling to the reader which is which.

Other than that the respective category is just another place to host. One doesn’t have to be logged in to read and if there are some who do not want to create a forum account to contribute I am sure we can find ways to make that work: send the contribution for discussion to qubes-users and I or others can post it then into the forum with proper attribution.

Regarding edits: there is a history of who changed what and mistakes/vandalism is easily detected/mitigated. We might form a group of ‘guardians’ who subscribe to notifications for any changes to those wiki posts, so unwelcome changes don’t stay up very long. If that fails, we can raise the trust level required for edits and have contributors below this level submit their changes as comments to be then applied to the wiki post by someone with trust level 2.

In general we want to trust the positive spirit of the community and hope it won’t be an issue.



This has been a long term project coordinated by many moderators and community members, particularly @tardiddles who kickstarted the project and did the ground work of importing the guides into the forum and @awokd who had floated around this idea in the past.

Thank you all for making this possible!


Docs links

Links to the docs can be found on the forum in various pages:

Docs page


This is really good, thank you all people involved for making it happen! :heart:


Awesome. :slight_smile:


Maybe we could even make this more visible by adding a link to the header banner. I can look into this in the future.

1 Like

I don’t think it needs more visibility. It’s already on the forum landing page.
You could not hide it inside the more button if you want to be more visible when we are not on the main page.
It’s also visible (without the search) in the side bar with the section ‘Community Guides’.

What would be nice to have in the header banner as links: (e.g.)


I still see a lot of people linking to pages in the Qubes-Community GitHub repo instead of this forum (recent example). I guess they don’t see the migration notice, because it’s only visible on the README, which they don’t see unless they happen to visit the main repo page.

Pinging @taradiddles

1 Like

User feedback:

Currently, there are links in the documentation pointing to GitHub. However, all that one finds on GitHub is a note that the content has been moved here, linking to a forum thread. This is a little bit confusing (+ privacy decreasing, as one has to visit one more website), so it is better to have the links in the documentation link directly to relevant forum threads.

1 Like

@qubist, please see this thread for a more recent discussion about this topic: