It is really nice and I think it would be a great idea to find more opportunities in the docs to mention security considerations like these that the developers had.
It would be a good contrast to the “WARNING” “DANGER” that one sometimes sees in other pages of the documentation. And we need people to feel reasonably safe using Qubes.
Anyways, it’s just a suggestion. I’ll keep an eye out for opportunities of introducing these facts on the docs.
Admonition use in docs
I did some basic table of the admonition use on qubes-doc in case anyone is interested.
Indeed, that was the intention. Naturally, being who we are with the experience we have, we focus more on what can go wrong and ways users can shoot themselves in the feet, but this might come across as a bit too heavy and negative after a while, so it’s a nice change of pace to point out cases where the user is protected without having to do anything or worry about it. We should highlight those features and implement more of them!
Actually on the integrated tutorial I’m working on it came up the idea of little tips like that that then have a button for the user to start a tutorial.
For example: the user tries to install software and a Qubey shows up instructing the user how to do it.
did you know?
Danger
Note
Note
