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

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

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

Laravel 文档同步问题

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

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

《L05 电商实战》
从零开发一个电商项目,功能包括电商后台、商品 & SKU 管理、购物车、订单管理、支付宝支付、微信支付、订单退款流程、优惠券等
《L03 构架 API 服务器》
你将学到如 RESTFul 设计风格、PostMan 的使用、OAuth 流程,JWT 概念及使用 和 API 开发相关的进阶知识。
最佳答案

去 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

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

完全可以自动化构建的

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

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

4年前 评论

去 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

4年前 评论
jcc123 4年前

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