本页面包含 Google 文档季接受的技术写作项目的详细信息。
项目摘要
- 开源组织:
- Qubes OS
- 技术文档工程师:
- 奢华
- 项目名称:
- 开始使用 QubesOS!编写开放且易用的指南
- 项目时长:
- 标准时长(3 个月)
Project description
开始使用 QubesOS!
我想为首次使用 QubesOS 的用户编写一份开放式指南和相关资料。目的是将 QubesOS 介绍给外行人,并使用类比、插图和图表,使指南尽可能简明易懂。为了保持简洁性,我们将使用指向可靠且可信资源的链接,其中最主要的是 QubesOS 网站上存在的资源。所有内容都将以开源许可发布。
这里的“独立”是指内容可以独立于网站而存在,例如手册。它与该指南的离线版本不等同。理想情况下,除了网站之外,还应创建另一个流水线,以便以指南的形式发布内容。
所谓“开放”,是指指南将根据开放许可发布。
可能的处理方式
定义目标受众群体
目前,我认为 QubesOS 定位的用户群还没有明确定义。QubesOS 如何帮助记者、律师、安全分析师、软件开发者等?请说明 QubeOS 在哪些场景中会很有用。
正确设定预期
还有必要提醒初次使用的用户,QubesOS 需要相当丰富的 IT 知识。从易用性方面来看,使用 QubesOS 需要付出代价,尤其是在 QubesOS 是您的主要计算系统时。同样,QubeOS 在某些方面(出于设计原因)表现不佳,例如在虚拟机中实现 3D 加速。请务必从一开始就明确说明,这是为了为潜在用户设置例外情况,而不是阻止用户使用。
QubesOS 是什么以及 QubesOS 不是什么
尽管 QubesOS 是一种特殊的操作系统(Xen 发行版),但根据其功能或缺乏功能将其与其他操作系统进行比较会很有趣(例如,Windows 越来越多地使用虚拟化和沙盒作为安全机制)。可以使用简单的图表/表格。
我们将与社区共同制定指南的规范。
该指南至少应包含哪些信息?安装可以在多大程度上简化,同时又不影响安全性?阈值应设在何处?是否有最小可行且安全的 QubesOS 设置?如果没有,则可以定义并将其设置为导视的目标。
许可
选择许可。广受好评的 Archlinux Wiki 使用的是 GNU 自由文档许可 1.3 或更高版本。此许可是否适合?
其他活动
提高网站文档的视觉吸引力
您可以使用红色或黄色突出显示记事,以便更轻松地注意到它们。例如,可以使用 archlinux wiki (https://wiki.archlinux.org/index.php/Linux_Containers) 中的颜色框。
可以使用块引用。
链接内容
文档网站目前有大量内容,但各个部分通常与其他相关主题没有关联。文章可以相互关联,以提高曝光度。