Opensuse-docs/minutes-meeting-11-27

会议纪要 2020年11月27日

背景

• 列举了未来文档中需要涵盖的重要主题：https://etherpad.opensuse.org/p/oS-docs-TableOfContent
• 在 https://github.com/Nycticorax/openSUSE-docs-revamped 启动了主要的文档仓库

目标

启动工作流程并推动项目进展。

讨论 & 完成事项

• Adrien：重申了对更以用户为中心的文档的需求，将最迫切的问题放在未来文档的中心位置；建议当前的文档对Tumbleweed用户和Linux新手不够友好
• Badr：强调了需要一个知识库来补充“正式文档”（即正式用户指南）
• 团队：同意了更以用户为中心的文档，从最常见的问题开始，并围绕它们构建知识库
• 团队：讨论了接下来的步骤
• Adrien：提出了不同的选项；

   1. lay out good ideas on top of technical information: make recommendations / best practices / give opinions for which tools to use and how; or
   2. take a step back: build autonomy with more distro-neutral tools for users to become capable of identifying and debugging their own issues

尚未做出决定。

• Mike：指出了当前辩论中的一个关键漏洞，即我们应该记录openSUSE的基础设施，并解释如何利用它为所有人带来好处
• Adrien：提到知识型文章应该有三个角度（如果相关）：解决实际问题，培养openSUSE技能（包括适用的基础设施），尽可能地培养自主性，更广泛地学习Linux；每个角度都可以通过交互进行折叠或展开
• Mike：强调了模块化文档的必要性，我们可以跨发行版重用其内容

后续行动

Badr：提出了mkdocs是否支持版本控制和类似知识库的内容结构的问题；他同意检查是否是这种情况（版本控制插件：https://github.com/zayd62/mkdocs-versioning）；如果mkdocs不提供此功能，则可以考虑其他解决方案。Attila：计划在下周上半部分配置Elastic Search堆栈。Mike：打算起草第一篇KB文章，记录软件-o-o