Laravel 社区文档同步问题(附解决方案)

请问社区文档怎么和官方文档内容保持一致?@Summer

最近很多小伙伴发现社区文档和官方有出入。是因为框架在不断优化,文档也会随之升级维护。最近一周,就有 11 位贡献者提交 31 次,27 个文件发生变化。

Laravel 文档同步问题

我每天会抽点时间查看官方仓库的提交记录,把我能处理的合并到社区文档中。但仍有大量修改没有合并。

请问有没有好的办法处理这种情况。

《L05 电商实战》
从零开发一个电商项目,功能包括电商后台、商品 & SKU 管理、购物车、订单管理、支付宝支付、微信支付、订单退款流程、优惠券等
《G01 Go 实战入门》
从零开始带你一步步开发一个 Go 博客项目,让你在最短的时间内学会使用 Go 进行编码。项目结构很大程度上参考了 Laravel。
最佳答案

去 Github 上查看官方仓库的提交记录,这种方式没法标记合并的状态,不适合社区协作。

解决方案

将所有提交记录罗列在一个共享的表格中,方便所有人查看、标记。使用 状态 列标记是否合并到社区文档中。

实现步骤

  1. Fork 官方文档仓库
  2. 使用 Pull 和官方仓库保持同步
  3. 使用 Zapier 检测 Github 提交记录,然后将信息插入 Google Sheets

成果

一个共享的 Google Sheets,所有均可查看、标记:Laravel Commit History

Laravel 社区文档同步问题

我通过 Zapier 创建的一个流程:My Zap

缺点

  • Zapier 免费版无自动运行功能,需手动执行
  • Google Sheets 需科学上网

扩展阅读

Pull:Keep your forks up-to-date via automated PRs

Zapier:The easiest way to automate your work

3年前 评论
jcc123 3年前
讨论数量: 4

完全可以自动化构建的

3年前 评论
leslieeilsel (楼主) 3年前
jcc123

得人工对比增量,社区人多力量大,改的不会太多。

3年前 评论

去 Github 上查看官方仓库的提交记录,这种方式没法标记合并的状态,不适合社区协作。

解决方案

将所有提交记录罗列在一个共享的表格中,方便所有人查看、标记。使用 状态 列标记是否合并到社区文档中。

实现步骤

  1. Fork 官方文档仓库
  2. 使用 Pull 和官方仓库保持同步
  3. 使用 Zapier 检测 Github 提交记录,然后将信息插入 Google Sheets

成果

一个共享的 Google Sheets,所有均可查看、标记:Laravel Commit History

Laravel 社区文档同步问题

我通过 Zapier 创建的一个流程:My Zap

缺点

  • Zapier 免费版无自动运行功能,需手动执行
  • Google Sheets 需科学上网

扩展阅读

Pull:Keep your forks up-to-date via automated PRs

Zapier:The easiest way to automate your work

3年前 评论
jcc123 3年前

讨论应以学习和精进为目的。请勿发布不友善或者负能量的内容,与人为善,比聪明更重要!