关于文档的组织架构 #1
Replies: 3 comments
-
另外入门指南的话,我个人的想法是缩小范围。框定 openSUSE TW、Fedora、Kubuntu(Ubuntu) 三个发行版。因为这三个发行版都有各自的特色: |
Beta Was this translation helpful? Give feedback.
-
目前整个项目的文档完成度:
|
Beta Was this translation helpful? Give feedback.
-
浅浅阅读一下,我觉得“教科书”的有些部分写得有些“维基”化。比如我觉得在介绍“硬件需求”方面应该教会用户如何检查硬件信息,安装系统的部分也可以穿插些操作系统的知识,不然需要看“教科书”的同学可能看不懂,能看懂“教科书”的同学可能就直接看维基了。 |
Beta Was this translation helpful? Give feedback.
-
在我的设想中,本指南大体上可以分为两部分。一个是教科书类,不仅仅展示过程,还要展示原理,对应前三部分(入门指南,进阶知识,高级教程)。另一个则是简明指南类。大概是这么一个架构:
这一部分应当指导用户切换到 Linux,安装和使用 Linux。在这一部分的结尾,应当有一个可用的浏览器与输入法(目前 Fedora 与 openSUSE 都是自带输入法和浏览器的。)
这一部分应当让用户了解 Linux 的概念,比如命令行、包管理器与用户权限。(教用户当一个不太合格的管理员)
打包,以及如何当一个合格的管理员。还包括一些如何对社群做贡献的内容。
解决需求的方案。比如游戏影音、办公、美化。这里的内容应该是读完入门或者有基础知识才读的。我们就没有必要讲解内容或者原理(HiDPI、Steam、使用 toolbx 来兼容发行版之流就可以归类到此)
一方面是传统的FAQ,另一方面教用户如何求助
关于项目本身,比如贡献指南与许可协议
架构成这样的原因是,群里有人说过嘛,那种简明的教程其实是需要读者有理解的基础才能做好的,不完全适合新手。我希望我们的读者在操作时知道自己在做什么。
Beta Was this translation helpful? Give feedback.
All reactions