2013 年 6 月 14 日,星期五

docrails,回归初心

发布者 fxn

历史背景

docrails 是 Ruby on Rails 的一个分支,旨在快速修复文档并定期与 master 进行交叉合并,有关 docrails 的更多信息,请参阅 什么是 docrails?

当 Pratik Naik 在 2008 年创建 docrails 时,他向任何感兴趣的人提供了提交代码权限(这是原始公告)。让我表达一下我对这个想法的赞赏。您知道,在开源中,提交权限被视为珍贵的宝藏,只有少数人才有,而 Pratik 却颠覆了它,鼓励大家对文档做出贡献。天才!

它甚至更进一步。GitHub 非常乐意为 docrails 翻转一个私密后台标志,启用公开写入访问,您甚至不必申请提交权限,就可以在不经允许的情况下克隆和推送。

事实证明这个想法是可行的,信任他人,你就会得到信任的回报。包括在内的大量人员已经能够改进 API 和指南,与提出请求的繁琐工作流相比,这种工作流微不足道。对于 Rails 提交者来说,这几乎需要同样的努力,补丁程序必须经同样的审查,但对于贡献者来说却要少得多,真是太棒了。

回归初心

GitHub 不久前不得不更改他们的基础设施,他们需要摆脱那个粗制滥造的标志(只有三个项目使用)。对于他们一直以来提供的服务,我们深表感谢。谢谢你们,伙计们!

随着标志的取消,我们回到了起点。docrails 现在归 Rails 组织所有,因此已从 lifo/docrails 移动到 rails/docrails。如果您想定期为 docrails 做出贡献,您可以申请提交代码权限(请联系核心团队的任何成员),或者向 Rails 本身提出文档更改建议,方法是向 rails/rails 提出请求。

请不要在 docrails 中打开请求,文档属于 Rails,并与源代码一起维护和演进,docrails 的目的是为您提供完全绕过请求的方法。