Cette page contient les détails d'un projet de rédaction technique accepté pour Google Season of Docs.
Résumé du projet
- Organisation Open Source:
- Qubes OS
- Rédacteur technique:
- luzeux
- Nom du projet:
- Découvrez QubesOS. Écrivons un guide ouvert et facile à utiliser.
- Durée du projet:
- Durée standard (3 mois)
Project description
Intégrez QubesOS !
Je souhaite créer un guide ouvert et des ressources associées pour les nouveaux utilisateurs de QubesOS. L'objectif est de présenter QubesOS aux non-spécialistes, et de faire en sorte que le guide reste aussi consciencieux et compréhensible que possible, à l'aide d'analogies, d'illustrations et de diagrammes. À cette fin, nous utiliserons des liens vers des ressources fiables, y compris avant tout celles présentes sur le site Web de QubesOS. Tout sera publié sous une licence libre.
Le terme "autonome" désigne un contenu pouvant exister indépendamment du site Web (un manuel, par exemple). Cela ne correspond pas à la version hors connexion de ce guide. Dans l'idéal, un autre pipeline sera créé pour publier le contenu en tant que guide en plus du site Web.
Le terme "ouvert" désigne un guide qui sera publié sous licence libre.
Comment ça marche ?
Définir l’audience cible
À ce jour, j'ai l'impression que la catégorie d'utilisateurs ciblée par QubesOS n'est pas bien définie. Comment QubesOS peut-il aider les journalistes, les avocats, les analystes de sécurité, les développeurs de logiciels, etc. ? Il serait intéressant de décrire les scénarios dans lesquels QubeOS peut s'avérer utile.
Définissez correctement vos attentes
Il est également important d'avertir les nouveaux utilisateurs que QubesOS nécessite un certain niveau de connaissances en informatique. L'utilisation de QubesOS a un prix à payer, surtout si QubesOS est votre système informatique principal. Sur le même jeton, certaines choses ne sont pas bien conçues par QubeOS (par exemple, l'accélération 3D dans les machines virtuelles). Il est important de le préciser dès le départ, et non de dissuader les gens de l'utiliser, mais de définir des exceptions pour les utilisateurs potentiels.
Qu'est-ce qu'est QubesOS et ce qu'est QubesOS ?
Même si QubesOS est un type particulier de système d'exploitation (une distribution Xen), il serait intéressant de le comparer à d'autres systèmes d'exploitation en fonction de leurs fonctionnalités ou de leur absence (par exemple, Windows utilise de plus en plus la virtualisation et le système de bac à sable comme mécanismes de sécurité). Un schéma/tableau simple peut être utilisé.
Les spécifications du guide seront définies avec la communauté.
Quelles sont les informations minimales que ce guide doit contenir ? Dans quelle mesure l'installation peut-elle être simplifiée sans compromettre la sécurité ? Où doit-il se situer ? Existe-t-il une configuration QubesOS minimale viable et sécurisée ? Si ce n'est pas le cas, elle peut être définie et définie comme cible du guide.
Licence
Prenez une licence. Le très respecté wiki Archlinux utilise la licence de documentation libre GNU version 1.3 ou ultérieure. Cette licence vous conviendrait-elle ?
Autres développeurs
Rendre la documentation du site web plus attrayante
Les notes peuvent être surlignées en rouge ou en jaune afin de les rendre plus faciles à remarquer. Vous pouvez par exemple utiliser des cases de couleur, comme celles que l'on trouve sur le wiki archlinux : https://wiki.archlinux.org/index.php/Linux_Containers.
Vous pouvez utiliser des guillemets.
Contenu du lien
Il existe actuellement un grand nombre de contenus pour le site Web de documentation, mais les éléments individuels ne sont souvent pas liés à d'autres sujets pertinents. Les articles peuvent être reliés entre eux pour améliorer la visibilité.