Diese Seite enthält die Details eines Projekts für technisches Schreiben, das für die Google-Staffel von Google Docs akzeptiert wurde.
Projektzusammenfassung
- Open-Source-Organisation:
- Qubes-Betriebssystem
- Technischer Redakteur:
- Luzeal
- Projektname:
- Mit QubesOS einrichten Verfasse einen offenen und nutzerfreundlichen Leitfaden.
- Projektdauer:
- Standarddauer (3 Monate)
Projektbeschreibung
Onboarding mit QubesOS!
Ich möchte einen offenen Leitfaden und zugehörige Materialien für neue QubesOS-Nutzer erstellen. Ziel ist es, QubesOS für Laien vorzustellen und den Leitfaden mithilfe von Analogien, Illustrationen und Diagrammen so klar und verständlich wie möglich zu halten. Dabei werden Links zu zuverlässigen und vertrauenswürdigen Ressourcen verwendet, insbesondere zu denen, die auf der QubesOS-Website zu finden sind. Alles wird unter einer offenen Lizenz veröffentlicht.
Mit eigenständig sind Inhalte gemeint, die unabhängig von der Website existieren können, zum Beispiel als Handbuch. Sie entspricht nicht der Offline-Version des Leitfadens. Idealerweise wird neben der Website eine weitere Pipeline zur Veröffentlichung der Inhalte als Leitfaden erstellt.
Mit „offen“ meine ich einen Leitfaden, der im Rahmen einer offenen Lizenz veröffentlicht wird.
Mögliche Vorgehensweise
Zielgruppe definieren
Ich habe heute den Eindruck, dass die Kategorie der Nutzer, auf die QubesOS ausgerichtet ist, nicht gut definiert ist. Wie kann QubesOS Journalisten, Anwälte, Sicherheitsanalysten, Softwareentwickler und so weiter unterstützen? Es wäre aufschlussreich, Szenarien zu beschreiben, in denen QubeOS nützlich sein kann.
Definieren Sie die richtigen Erwartungen
Außerdem ist es wichtig, neue Nutzer darauf hinzuweisen, dass QubesOS ein ausreichendes IT-Wissen erfordert. Die Nutzung von QubesOS ist im Hinblick auf die Nutzerfreundlichkeit kostenpflichtig, insbesondere wenn QubesOS Ihr primäres Computersystem ist. Auf dem gleichen Token gibt es Dinge, die QubeOS nicht gut funktioniert, z. B. die 3D-Beschleunigung in virtuellen Maschinen. Es ist wichtig, dies von Anfang an klar zu machen, nicht um Nutzer von der Verwendung abzuhalten, sondern um Ausnahmen für potenzielle Nutzende festzulegen.
Was QubesOS ist und was nicht ist
Obwohl QubesOS eine spezielle Generation von Betriebssystemen (eine Xen-Distribution) ist, wäre es interessant, es aufgrund ihrer Funktionalität oder ihres Fehlens mit anderen Betriebssystemen zu vergleichen. So setzt beispielsweise Windows zunehmend Virtualisierung und Sandboxing als Sicherheitsmechanismen ein. Ein einfaches Diagramm/eine einfache Tabelle könnte verwendet werden.
Die Spezifikationen des Leitfadens werden mit der Community festgelegt.
Welche Informationen sollte der Leitfaden mindestens enthalten? Wie sehr kann die Installation ohne Abstriche bei der Sicherheit vereinfacht werden? Wo sollte der Grenzwert liegen? Gibt es eine minimal realisierbare und sichere Einrichtung von QubesOS? Falls nicht, könnte er definiert und als Ziel für den Guide festgelegt werden.
Lizenz
Hol dir eine Lizenz. Das anerkannte Archlinux-Wiki verwendet die GNU Free Documentation License 1.3 oder höher. Eignet sich diese Lizenz für Sie?
Andere Ziele
Websitedokumentation optisch ansprechender gestalten
Notizen können rot oder gelb hervorgehoben werden, um sie leichter zu erkennen. Beispielsweise können Farbfelder verwendet werden, wie sie im Archlinux-Wiki unter https://wiki.archlinux.org/index.php/Linux_Containers zu finden sind.
Blockzitate können verwendet werden.
Linkinhalte
Es gibt derzeit recht viel Inhalt für die Dokumentationswebsite, aber die einzelnen Teile sind oft nicht mit anderen relevanten Themen verlinkt. Artikel könnten miteinander verknüpft werden, um die Auffindbarkeit zu verbessern.