本頁面包含 Google Season of Docs 接受的技術寫作專案詳細資料。
專案摘要
- 開放原始碼機構：
- Qubes OS
- 技術撰稿人：
- luzeal
- 專案名稱：
- 開始使用 QubesOS！讓我們編寫開放且易於使用的指南
- 專案長度：
- 標準長度 (3 個月)
Project description
Onboard with QubesOS !
我想為 QubesOS 初學者建立開放指南和相關教材。目標是向一般人介紹 QubesOS，並盡可能簡潔易懂地說明，使用類比、插圖和圖表。為求簡潔，我們會使用可靠且值得信賴的資源連結，包括 QubesOS 網站上的資源。所有內容都會以開放授權形式發布。
所謂獨立內容，是指可獨立於網站存在的內容，例如手冊。這與離線版指南不同。理想情況下，系統會建立另一個管道，將內容發布為指南，並與網站並行。
所謂開放，是指指南會以開放授權發布。
可能的做法
定義目標對象
就目前而言，我認為 QubesOS 的目標使用者類別定義不夠明確。QubesOS 如何協助記者、律師、安全分析師、軟體開發人員等？請說明 QubeOS 的實用情境。
設定正確的期望
此外，也請務必提醒初次使用者，QubesOS 需要相當程度的 IT 知識。使用 QubesOS 必須付出代價，尤其是以 QubesOS 做為主要運算系統時，在可用性方面更是如此。同樣地，QubeOS 也有一些 (刻意設計的) 缺點，例如虛擬機器中的 3D 加速功能。請務必一開始就清楚說明，這不是為了阻止使用者使用，而是為了讓潛在使用者瞭解情況。
QubesOS 的用途與不適用情境
雖然 QubesOS 屬於特殊類型的作業系統 (Xen 發行版本)，但根據功能或缺乏功能 (例如 Windows 越來越常使用虛擬化和沙箱做為安全機制)，將其與其他作業系統進行比較會很有趣。可以使用簡單的圖表/表格。
指南規格將由社群定義。
指南至少應包含哪些資訊？如何簡化安裝程序，同時確保安全性？門檻應設為多少？是否有最低可行且安全的 QubesOS 設定？如果沒有，可以定義並設為指南的目標。
授權
領取執照。備受推崇的 Archlinux 維基百科使用 GNU 自由文件授權 1.3 以上版本。這個授權是否適合？
其他工作
讓網站說明文件更具視覺吸引力
你可以使用紅色或黃色標示附註，方便自己注意。舉例來說，可以使用顏色方塊，例如 archlinux wiki 中的顏色方塊。https://wiki.archlinux.org/index.php/Linux_Containers。
可以使用引用文字。
連結內容
目前文件網站的內容相當豐富，但個別內容通常不會連結至其他相關主題。文章可以互相連結，提高曝光度。