招募维护者 Chef 与 Cook

[ccmywish]

见 #275

DEPRECATE THIS ISSUE

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

我们的代码里使用了 recipe (某个菜的烹饪方法) 这个词，因而整个项目便和 “饮食” 有关，比如 menu: 汇集了所有的 target 的菜单。因此，我们的维护者身份依然使用了这个惯例：

一个 recipe 的协作者可分为：

1. Chef

   主厨: 对一个 recipe 完全负责，有写权限时可以直接推代码

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

2. Cook

   副厨：实现和持续维护 recipe，需要和 Chef 一起 review 代码。可参考 02-提交与贡献.md 了解项目是如何进行提交和审阅代码的

---

项目采用申请制，Chef 仅有1人，Cook 可有多人。

1. 请提交 PULL REQUEST 在对应的 recipe 文件中添加自己
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]

Chef

和 Cook 的要求一样，但是具有最高的责任。

责任只是针对于 chsrc 项目的维护来说的，采用 GPL 的项目，不对软件用户承担任何责任。

Cook

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

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

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

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

   举例：chsrc 原本是一个4000行的单文件，这对于 C 语言项目来说很常见。但是为了让大多数人能够方便参与维护，花了许多功夫全部拆分为单个文件。再举例，04-为什么拒绝使用代码格式化工具.md

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

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

写权限

待长时间协作后，大家都完全认可了 Chef 和 Cook 的身份和能力后，我将开放该仓库的写权限。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.