文档:会议

跳转到:导航搜索

未来的会议

过去的会议

每个第二周五在 [1800 UTC] 在 [meet.opensuse.org/opensuse-docs] 或如果 meet.opensuse.org 无法访问,将在 https://meet2.opensuse.org/opensuse-docs 举行

会议 #10 | 2021年4月16日

会议重点是 pyspelling 和 weblate。会议记录

会议 #9 | 2021年1月5日

会议重点是修订后的文档目录。会议记录

会议 #8 | 2020年11月18日

会议重点是如何推广 openSUSE 发行版并相应地调整文档。会议记录

会议 #7 | 2020年11月27日

会议重点是如何开始使用全新的文档平台。会议记录

会议 #6 | 2020年11月20日

会议将重点讨论文档平台。请带上您最喜欢的平台的优点!

会议 #5 | 2020年11月6日

会议记录在此:https://lists.opensuse.org/archives/list/doc@lists.opensuse.org/thread/JVMUOFY5IIED42ZWXF7WHEFYXCI6HJF6/

会议 #4 | 2020年10月23日

请考虑为即将到来的会议做准备,会议时间为10月23日晚上6点 UTC:opensuse-docs/prep-meeting-10-23

会议 #3 的记录在此

会议 #3 | 2020年10月8日

议程征集

  • 检查作业
  • 确定可以完成哪些任务来改善以下部门的学习体验
    • 开拓新领域:创建一个易于查看的、10'000 英尺鸟瞰图,展示 openSUSE 社区,让新用户了解 openSUSE 社区和生态系统
    • 预安装指南:帮助用户了解他们的用例在 openSUSE 发行版的世界中的位置,并提前考虑重要的安装选项
    • 安装程序助手:通过识别安装程序中的明确转折点来构建信息,帮助人们了解后果(显然与预安装指南部分重叠)
    • 安装后指南:最佳实践、工作流程以及安装后提示和技巧
  • 围绕这些任务构建工作流程

会议 #2 | 9月24日

  • 出席者:Ivo、Attila、Andrès、Thomas
  • 没能参加,但我们期待下次见到你们
    • Mike、Stephan、Lana
讨论并接受
  • 专注于改善访问 openSUSE 发行版(Leap、Tumbleweed 和 microOS)的新用户的学习体验
  • 从审查和测试 Windows 10 用户安装和部署 Live USB 会话的指南开始(Rufus 不再起作用)
  • 在视频适合的情况下使用视频(演示“设置和使用 openSUSE 发行版有多么简单和容易” + 如何设置桌面级高效工作流程和最佳实践的实时教程),并用文本和其他媒体补充视频不擅长的领域(例如,逐步精确的说明或“非常重要的注意事项”)
  • 将当前的非技术文档(例如,wiki)与已有的内容整合起来(如果作者愿意,可以考虑 "https://github.com/cb400f/opensuse-guide.org" 部署在 "https://guide.opensuse.net.cn/")
  • 从 Arch Wiki 中汲取灵感,将其作为快速可编辑的知识库(我现在评论一下:可能在故障排除方面,同时仍然专注于哪些有效,因为所有详细信息和技术背景都将从 Arch wiki 中获得)
  • 启动一个“起始”工作流程(参见下面的作业)
作业
  • Ivo 将向团队提供视频指南的具体要求
  • Andrès 和 Adrien 将开始测试从 Windows 10 平台创建 Live USB 环境,Tomas 将进行同行评审(如果需要)
  • Attila 将联系 "opensuse-guide.org" 的作者
  • Attila 将为团队准备一个良好的工作流程,以便可以承担、同步和共享所有任务,而不会产生过多的开销或重复
  • Adrien 将起草一封信/消息发送给社区(与上述任务同步),以在需要时获得更多帮助
下次会议前需要讨论的事项
  • 下次会议何时举行?
下次会议需要讨论的事项

1 检查作业 这可能需要整个会议时间。其他可能的讨论主题:2 确定可以完成哪些任务来改善以下部门的学习体验

    • 开拓新领域:创建一个易于查看的、10'000 英尺鸟瞰图,展示 openSUSE 社区,让新用户了解 openSUSE 社区和生态系统
    • 预安装指南:帮助用户了解他们的用例在 openSUSE 发行版的世界中的位置,并提前考虑重要的安装选项
    • 安装程序助手:通过识别安装程序中的明确转折点来构建信息,帮助人们了解后果(显然与预安装指南部分重叠)
    • 安装后指南:最佳实践、工作流程以及安装后提示和技巧

3 围绕这些任务构建工作流程

会议议程

  • 介绍
  • 讨论新用户(“新” = 想安装或最近安装)的学习体验
    • Leap / TW / microOS / Kubic / Containers 的学习体验是否良好?重点在哪里?
    • 同意哪些有效:您有什么成功的学习体验的例子?
    • 使用现有内容:我们可以保留哪些?哪些需要更新?哪些需要替换?
    • 构建持久性:如何确保我们所做的事情易于未来贡献者维护?如何最大程度地减少“内容”债务?
  • 如何构建内容?一个简单的例子
    • 开拓新领域:创建一个易于查看的、10'000 英尺鸟瞰图,展示 openSUSE 社区,让新用户了解 openSUSE 社区和生态系统
    • 预安装指南:帮助用户了解他们的用例在 openSUSE 发行版的世界中的位置,并提前考虑重要的安装选项
    • 安装程序助手:通过识别安装程序中的明确转折点来构建信息,帮助人们了解后果(显然与预安装指南部分重叠)
    • 安装后指南:最佳实践、工作流程以及安装后提示和技巧
  • 实际项目
  • 需要同意
    • 寻找更多人来帮忙?
    • 团队?用户体验(幻灯片/文本/视频)/测试/沟通
  • 家务事:我们应该多久开会一次?我们可以交替时间吗?

启动会议:2020年9月17日

议程征集

会议记录

出席者:Andrés Adrien Attila Frank Lana

  • Frank 介绍了 SUSE 文档团队的工作方式,以及文档仓库 (https://github.com/SUSE/doc-sle) 的工作方式。文档是用 Docbook XML 编写的,并使用 DAPS 工具链。仓库向任何希望贡献的人开放 PR。
  • 讨论是否可以将新指南直接添加到仓库中,或者我们是否应该启动不同的/新的仓库。Frank 确认可以将新指南添加到现有的文档仓库中,不需要新的仓库。
  • Adrien 概述了视频提案,一个为新手准备的短视频系列。讨论了视频提供的价值,以及普遍认为它们会带来价值。
  • 讨论了现有的 wiki,以及与其他项目(KDE、Ubuntu 等)如何组织文档(wiki、正式文档、视频、论坛等)进行比较。
  • 讨论了拥有一个中央站点,让人们可以选择他们喜欢的文档形式。openSUSE 有许多可用的域名,但 doc.opensuse.org 似乎是最合理的。该站点的代码在 github (https://github.com/openSUSE/doc-o-o) 中。这可能是该团队的最佳起点。

行动项(所有人) 查看 doc-o-o GH 仓库,请求访问权限,并思考如何更新它以充当文档门户。

  • 此外,我们希望在主 opensuse.org 上添加重定向(可能以顶部右角“文档”链接的形式)。

行动项(Frank & Lana) 确定拥有该站点的人员以及如何添加该链接。

  • 家务事:Lana 提出交替的日程安排和时区,这意味着每个人至少每隔几周都能参加会议。

行动项(Lana) 设置会议日程并发送详细信息。

  • 讨论如何开始。Frank 建议我们进行头脑风暴。

行动项(所有人) 将我们想要处理的文档项目想法添加到 wiki,以便在未来的会议中进行优先级排序和计划。