近期的重要工作事项

[zccrs]

• [ ] 在 wiki.deepin.org 中提供类似于 https://wiki.debian.org/Packaging 的内容
• [x] PR构建支持 Archlinux 和 Debian Sid @justforlxz 在PR的 Actions 中即可看到效果
• [x] 支持自动构建 commit 进仓库，并对外公开此仓库 @justforlxz
• [x] 设计一个 system release 项目，用于管理仓库和发布 @justforlxz
• [x] #3267
• [x] 调研 OBS
• [x] 为贡献者提供签署 CLA 协议的支持 @tsic404
• [x] 制定 Qt/C++ 项目文档编写规范 @BLumia
• [x] CI 增加文档检查工具 @tsic404
• [x] 提供 develop.deepin.org 开发者文档网站 @myml
• [x] 重建 www.deepin.org 官方首页 @myml
• [x] wiki.deepin.org 支持多语言切换 @myml
• [ ] 在 wiki 中提供和维护 FAQ 内容 @babyfengfjx
• [x] 制定“兴趣小组”成立的规范和要求 @BLumia
• [x] 成立 RISC-V 适配兴趣小组 @Zeno-sole
• [x] 成立内测兴趣小组 @babyfengfjx
• [x] 开发贡献者数据统计工具，在系统发布时自动收集本轮更新的贡献者名单，集成在系统发布日志中致谢 @tsic404
• [ ] 软件发布前同步在Archlinux、Debian中进行冒烟测试，并制定保障测试的工具或机制 @babyfengfjx
• [x] 提供公开的社区贡献展示网站，展示社区开发者的贡献数量 @myml
• [ ] 软件包进仓库之前检查是否存在对应的tag，确保进仓之前存在tag @Zeno-sole

[zccrs]

每一条任务需要的时候可以建成独立的issue进行跟踪和更新

[hillwoodroc]

需要我在 openSUSE 上开个 bug 讨论增加 obs 对 deepin 的支持吗？

[BLumia]

需要我在 openSUSE 上开个 bug 讨论增加 obs 对 deepin 的支持吗？

虽说基础配置（meta）我这边初步来看就只是配置一个 DoD 仓库源就可以了，但我们这边暂时还没有得出一个适用于 deepin v20 的 prjconf 配置。鉴于 deepin 组件的可移植性问题还不少，所以恐怕暂时不会优先去研究 obs，但能先有相关的进展还是很好的。如果有相关讨论的话，可以贴来，我这边也可以关注一下 :)

[justforlxz]

PR构建支持 Archlinux 和 Debian Sid 支持自动构建 commit 进仓库，并对外公开此仓库

状态: 已完成 ✅ 使用指南: https://wiki.deepin.org/zh/开发者指南/仓库/使用action创建新的git仓库 后续计划: 优化执行脚本，减少冗余指令。

[BLumia]

文档规范涉及到一些可实施方面的细节，考虑到各个研发组应该是优先考虑提供中文文档的，但又希望源码中尽可能不出现中文，则需要合适的本地化方案。目前的测试方案见附件，使用分离的 doxygen 文档来编写配置，缺点则是需要能够有方式为现有接口生成分离的 doxygen 文档的框架结构以供研发填充（一个 class 对应一个 .zh_CN.dox 文档，目前相当于差一个这样的生成工具）。

代码文档注释覆盖率的检查方案已基于目前的文档翻译方案初步确定，使用 coverxygen 进行检查（忽略 file 注释）。

dtkcore.zip

一个对应的讨论帖： https://github.com/linuxdeepin/developer-center/discussions/3283

[Zeno-sole]

• [ ] [为 system release 项目提供自动构建 ISO 和自动发布的Action ] (讨论中，计划通过Jenkins触发方式回调到内网)
• [ ] 成立 RISC-V 适配兴趣小组 (已完成加入标准、成立背景、目标介绍等内容 具体成立方式待相关规范确认后进行)

[tsic404]

为贡献者提供签署 CLA 协议的支持

cla检查采用cla-assistant项目，该项目提供了cla-assistant.io公开服务。在linuxdeepin/deepin-riscv中做了测试。 当前状态：在调研cla-assistant的api。

[zccrs]

为贡献者提供签署 CLA 协议的支持

cla检查采用cla-assistant项目，该项目提供了cla-assistant.io公开服务。在linuxdeepin/deepin-riscv中做了测试。 当前状态：在调研cla-assistant的api。

这工具不会自动过滤掉属于组织的成员，不过即便是受deepin雇佣的开发者签署了CLA应该也没问题。 @felixonmars 觉得呢？

[tsic404]

有配置可以过滤组织的成员吧

[justforlxz]

PR构建支持 Archlinux 和 Debian Sid 支持自动构建 commit 进仓库，并对外公开此仓库

状态: 已完成 ✅ 使用指南: https://wiki.deepin.org/zh/开发者指南/仓库/使用action创建新的git仓库 后续计划: 优化执行脚本，减少冗余指令。

创建了一个 issue 专门处理 tag 同步。 https://github.com/linuxdeepin/developer-center/issues/3268

[zccrs]

有配置可以过滤组织的成员吧

不太适用，没法用邮箱地址匹配。实际上我们还需要 linuxdeepin 组织里有一部分人还是得签署CLA

[BLumia]

设计一个 system release 项目，用于管理仓库和发布

关于 PR 需要进入测试仓库的需求：与 @justforlxz 讨论后，暂定依据发起人所使用的分支名称来决定是否进入测试仓库。若分支名称包含 topic- 前缀且其与已有的测试主题能够对应匹配，则使用对应的测试主题仓库进行构建和入库。若无主题匹配或无此前缀，则视为普通提交，使用正式发布仓库进行构建。

• 假定发起人 username 发起 PR 时使用的分支是 username:topic-example，且存在 topic-example 测试主题，则对应分支的构建进入与 topic-example 测试主题对应的测试仓库。
• 假定发起人 username 发起 PR 时使用的分支是 username:patch-1，由于分支并非以 topic- 为前缀，则直接使用正式发布仓库进行构建。

[myml]

wiki添加了本地标题编辑支持，这样就可以在切换语言时，跳转到对应的页面，不再局限于路径 https://github.com/linuxdeepin/wiki/tree/myml/title-locales

[BLumia]

文档编写规范相关：

1. 编写方式和策略已确定，也公布在了这里（持续更新）。对此有问题或感兴趣的欢迎在相应的讨论帖进行讨论
2. 初步使用 Codeberg Pages 提供在线文档
   • 可访问这里预览效果，对应到这个仓库的 docs-master 分支
   • Codeberg Pages 可提供不同分支的静态页的直接访问，可使用类似 docs/x.y.z 的格式用于提供不同版本的文档访问
   • Codeberg Pages 对分支名称包含 / 字符的支持有问题，已向上游提交相关 patch
3. 目前的文档生成相关的配置其实有一些配置项是在 workaround 相应的问题，问题已经反馈至上游，见 https://github.com/doxygen/doxygen/issues/9437 与 https://github.com/doxygen/doxygen/issues/9438 。

SIG 规范相关：

1. 当前拟定的相关规范和流程等事项见 https://github.com/deepin-community/SIG ，后续新 SIG 的创建以及相关管理活动的开展也计划公开透明的在此仓库进行。
2. RISC-V、内测小组以及 Wiki 小组可以考虑按此仓库中提供的步骤填充相应小组的信息了 @Zeno-sole @babyfengfjx 。
3. 预计下周会有面向论坛、公众号之类渠道的文章公示，大体会基于此仓库的内容编写对应文章，若有缺少的资料会直接补充自仓库。
4. 如果你是社区贡献者，想更加深入的参与进来的话，欢迎在 SIG 仓库的 Issue 或讨论板里一同讨论 :)

[zccrs]

文档编写规范相关：

1. 编写方式和策略已确定，也公布在了这里（持续更新）。对此有问题或感兴趣的欢迎在相应的讨论帖进行讨论

2. 初步使用 Codeberg Pages 提供在线文档

   • 可访问这里预览效果，对应到这个仓库的 docs-master 分支
   • Codeberg Pages 可提供不同分支的静态页的直接访问，可使用类似 docs/x.y.z 的格式用于提供不同版本的文档访问
   • Codeberg Pages 对分支名称包含 / 字符的支持有问题，已向上游提交相关 patch
3. 目前的文档生成相关的配置其实有一些配置项是在 workaround 相应的问题，问题已经反馈至上游，见 Avoid empty Markdown page get generated doxygen/doxygen#9437 与 @~... is blocking the automatic page name generation in Markdown file doxygen/doxygen#9438 。

SIG 规范相关：

1. 当前拟定的相关规范和流程等事项见 https://github.com/deepin-community/SIG ，后续新 SIG 的创建以及相关管理活动的开展也计划公开透明的在此仓库进行。
2. RISC-V、内测小组以及 Wiki 小组可以考虑按此仓库中提供的步骤填充相应小组的信息了 @Zeno-sole @babyfengfjx 。
3. 预计下周会有面向论坛、公众号之类渠道的文章公示，大体会基于此仓库的内容编写对应文章，若有缺少的资料会直接补充自仓库。
4. 如果你是社区贡献者，想更加深入的参与进来的话，欢迎在 SIG 仓库的 Issue 或讨论板里一同讨论 :)

DTK的接口文档能对接到 docs.deepin.org 吗

[BLumia]

DTK的接口文档能对接到 docs.deepin.org 吗

我看之前（或者目前公开的） docs.deepin.org 里对 dtk 的文档是指向别的地方的链接，如果保持一样的方式的话就是改个链接就行了。另外，文档生成得到的是 html，所以如果希望自行提供的话直接拿走生成的 html 用即可。无论如何，总有方案可以达到预期效果。

[zccrs]

DTK的接口文档能对接到 docs.deepin.org 吗

我看之前（或者目前公开的） docs.deepin.org 里对 dtk 的文档是指向别的地方的链接，如果保持一样的方式的话就是改个链接就行了。另外，文档生成得到的是 html，所以如果希望自行提供的话直接拿走生成的 html 用即可。无论如何，总有方案可以达到预期效果。

你再看一下现在这个新的 docs.deepin.org（可能内网的dns还没更新，可以手机访问试试）, 文档不会跳转到其它网站，而且如果直接放html，在样式上没法与 docs.deepin.org 统一。

[BLumia]

你再看一下现在这个新的 docs.deepin.org, 文档不会跳转到其它网站，而且如果直接放html，在样式上没法与 docs.deepin.org 统一。

现在放的应该是之前提供 Markdown 的那套方案的文档，从 chinauos 获取的。这里肯定要调整的，chinauos 目前的这套方案效果也比较糟糕。

样式和效果方面之前和 @myml 确认过，应该没什么问题，具体可以对接的时候再看具体情况处理。

[BLumia]

设计一个 system release 项目，用于管理仓库和发布

与 @justforlxz 的 tag 同步工具以及 tag 规范相关的事情。tag release 功能正式上线后，应当回收各个项目组直接在 GitHub 创建 release 的权限，使 tag 创建（版本发布）一律走内部审批而不是先 GitHub 打 tag 后测试的流程。这样应该能避免后续不小心创建 tag 的情况，也避免已创建的 tag 被删除（新 tag 规范不允许删除已发布的 tag）。

回收权限指把 maintain 权限下调至 write，调整前需要再次确认是否有其它影响。

[myml]

新的官网首页已经上线