Directors & Maintainers 招募维护者

[ccmywish]

作为某个语言的资深用户、某个软件的专家、镜像站维护人员等，你总是对镜像站和源的可用状态拥有一手信息，我们需要你的帮助。如果想要达到最理想的维护状态，每一个 recipe 都需要有专人长时间维护。所以我们需要记录的是愿意长期维护的人，如果是一次性提交代码，只需要在对应 recipe 的文件标头中记录即可。

一个target的协作者可分为：

1. Director

   负责人，对一个 recipe 完全负责。

   目前项目的发展阶段还处于 外行实现内行 的情况，比如 Homebrew recipe，实现者根本不是 Homebrew 的真实用户，只是根据各种文档来实现，然后等待用户反馈。所以这里当前的实现者最多只能是 Maintainer，无法承担 Director 的责任

2. Maintainers

   维护者，实现和持续维护 recipe

3. Observers

   观察者，对该 target 持续反馈和关注的用户。如果你觉得你无法承担作为维护者的责任，可以退而求其次作为观察者积极参与其中。

考虑到真正参与维护的人并不多，所以上述人数均不设限。

---

1. 请提交 PULL REQUEST 在 MAINTAINERS.md 文件中添加自己
2. 请在此处留言
3. 仅需上述两步即可获得身份，但你的行为将会决定成员是否认可你，将最终决定你是否有写权限

[wickdynex]

Hi @ccmywish,

I would like to express my interest in becoming an observer or maintainer for the Homebrew and Ubuntu packages. I’m keen to follow updates and provide feedback for these projects.

Could you please provide more details on what technical skills or knowledge are needed to participate as an observer or maintainer? I’m eager to contribute in any way I can🥰.

Looking forward to your response!

[ccmywish]

Director

和 Maintainer 的要求一样，但是具有最高的责任。PS：责任只是针对于 chsrc 项目的维护来说的，采用 GPL 的项目，不对软件用户承担任何责任。

Maintainer

1. Maintainer 需要将镜像站的换源指南（往往是 shell 语言编写的）转写为 C 语言的 recipe，这需要对这两种语言都比较熟悉。

2. Maintainer 需要对自己 recipe 所涉及的操作系统的一些细节比较熟悉，比如不同操作系统上的 cp 命令是不同的，支持的选项也不同。这个需要在实践中逐渐踩坑、认识、学习。

3. chsrc 的目标是产生极其干净易维护的代码。Maintainer 可以有 “强迫症”，需要自己思考什么样的代码更具有可维护性，主动 清理改善代码

   我希望能够吸引用户的不仅是它的功能，而且也是因为它高质量、漂亮而又易懂的代码。（因为现在是一个不缺工具的时代，用户同样注重内部情况）。上层采用C语言的项目越来越少，chsrc 作为依旧使用C语言的项目，刚好利用了C语言的性质（现在提跨平台，谁又能想到C语言呢？），希望能成为一个标杆，作为后续学习C语言的人都可参与学习和贡献的项目。

   举例：chsrc 原本是一个4000行的单文件，这对于 C 语言项目来说很常见。但是为了让大多数人能够方便参与维护，花了大力气全部拆分为单个文件。再举例：代码是有鲜明的格式的，但是这种并不是靠 clang-format 完成的，而是靠手动实践，因为工具总是缺少我们想要的某个非常细的点，工具的强制性破坏了我们代码的美观性。这样的例子还可以举出很多，很多感受只有亲身长时间维护才能明白。

4. Maintainer 需要对该仓库中自己所维护的 recipe 的 issue / PR 负责。

5. Maintainer 负责 recipe 的实现，所以需要对 chsrc 的代码有基本了解，能够使用 framework 中的 API 来完成代码。然而实际上 framework 已经承担了大量的包装任务，这就是为什么 README 中说，即使不需要很懂C语言也可以贡献。所以，Maintainer 的一个更深层次的任务是去逐渐改善 framework，以便所有 recipe 的 Maintainer 可以共享。

Observer

1. 需要负责测试实现后的结果

2. 关注各大镜像站状态（参考Wiki我们支持的镜像站），关注源的变化

3. 关注软件本身的变化，比如 Homebrew 近年来已经发生了巨大的变化

4. 配合 Maintainer 和 Director 管理 issue 审核 PR

写权限

待长时间协作后，大家都完全认可了 Director 和 Maintainer 的身份和能力后，我将开放该仓库的写权限。Observer 由于贡献代码不多，所以不开放写权限

[ccmywish]

@wickdynex

👍👍👍很感谢你对维护感兴趣，我在上面补充了对三者的职能和要求，如果确认没问题，可以直接提交PR修改 MAINTAINERS.md 文件即可。

[wickdynex]

@wickdynex

👍👍👍很感谢你对维护感兴趣，我在上面补充了对三者的职能和要求，如果确认没问题，可以直接提交PR修改 MAINTAINERS.md 文件即可。

I'd like to be the Ubuntu and Homebrew Observer and already create a PR #135. Does each section limit the count of member? I wanna be the maintainer or director as I'm familiar with these developing process🥰.

[ccmywish]

@wickdynex

考虑到真正参与维护的人并不多，所以上述人数均不设限

I think the number of people who are and who will be actually involved in the code maintenance is very small.

I really appreciate it if you can offer to be a director or maintainer! In fact, the observer role is designed more to encourage people who are not familiar with C and Shell code, as a way to still actively participate in the project.

[happy-game]

我有兴趣成为python, nodejs, docker,fedora, arch的manitainer, 因为我现在经常使用这几个语言和系统.

另外我还可以成为openwrt, conda, debian的observer, 因为我有这些环境但并不常用, 可以对该它们进行测试和debug.