本頁面包含 Google 技術文件季度接受的技術寫作專案詳細資料。
專案摘要
- 開放原始碼組織:
- Qubes OS
- 技術撰稿人:
- luzeal
- 專案名稱:
- 歡迎使用 QubesOS!讓我們編寫開放且易於使用的指南
- 專案長度:
- 標準長度 (3 個月)
Project description
歡迎使用 QubesOS!
我想為首次使用 QubesOS 的使用者建立開放指南和相關素材。目標是向業餘介紹 QubesOS,並使用類比、插圖和圖表,盡可能使指南內容清楚明瞭且易於理解。為了讓內容簡潔,我們會使用可靠且值得信賴的資源連結,其中最重要的是 QubesOS 網站中的連結。所有內容都會根據開放授權發布。
請獨立地說,這類內容可能獨立存在於網站,例如手冊的內容。這與離線版指南不同。理想情況下,除了網站外,系統還會建立另一個將內容發布為指南的管道。
開放指南是指根據開放授權發布的指南。
可能的處理方式
定義目標對象
就目前而言,我認為 QubesOS 指定的使用者類別並未明確界定。QubesOS 如何協助記者、律師、資安分析師、軟體開發人員等?請說明 QubeOS 可發揮作用的情況,這會很有幫助。
正確設定期望
您也應提醒初次使用者,QubesOS 需要相當程度的 IT 知識。使用 QubesOS 的使用者體驗有其代價,特別是如果 QubesOS 是您主要的電腦系統。同樣地,QubeOS 無法 (根據設計) 執行某些功能,例如在虛擬機器中提供 3D 加速功能。請務必從一開始就清楚說明,這並非為了阻止使用者,而是為了讓潛在使用者瞭解預期結果。
QubesOS 的定義和範圍
雖然 QubesOS 是特殊的作業系統 (Xen 發行版),但根據其功能或缺乏的功能 (例如 Windows 越來越使用虛擬化和沙箱作為安全機制),您會想將該系統與其他作業系統進行比較。可以使用簡單的圖表/表格。
我們會與社群共同定義指南的規格。
指南應包含哪些必要資訊?在不犧牲安全性的情況下,該如何簡化安裝作業?門檻應設在哪裡?是否有最小可行且安全的 QubesOS 設定?如果沒有,則可以定義並設為指南的目標。
授權
領取執照。Archlinux 維基網頁廣受尊重,使用的是 GNU 免費文件授權 1.3 以上版本。此授權是否適合 ?
其他企圖
讓網站說明文件在視覺上更引人注目
你可以使用紅色或黃色標示筆記,讓筆記更容易被注意到。例如,可以使用顏色方塊,像是在 archlinux 維基網頁中找到的顏色方塊。https://wiki.archlinux.org/index.php/Linux_Containers。
可以使用大段引號。
連結內容
目前說明文件網站的內容相當豐富,但個別內容通常不會連結至其他相關主題。文章之間可以互相連結,提高曝光度。