同步操作将从 WMJ/PDFPatcher 强制同步,此操作会覆盖自 Fork 仓库以来所做的任何修改,且无法恢复!!!
确定后同步将在后台操作,完成时将刷新页面,请耐心等待。
欢迎使用 PDF 补丁丁! 本文档是有关如何为 PDF 补丁丁 做出贡献的指南。如果发现不正确或缺失的内容,请留下评论/建议。
请参阅 README。
无论是对于拼写错误,Bug 修复还是重要的新功能,我们总是很乐意接受您的贡献。请不要犹豫,在 Github Issue 上进行讨论。
我们非常重视文档,我们很高兴接受这些方面的改进。
我们将 master
分支用作开发分支。
这是贡献者的工作流程 :
复刻 (Fork) 到您的个人仓库。
克隆到本地。
git clone git@github.com:yourgithub/PDFPatcher.git
创建一个新分支并对其进行处理。
git checkout -b your_branch
(不建议将 master
作为 your_branch
。)
保持分支与上游仓库同步:
git remote add upstream git@github.com:wmjordan/PDFPatcher.git
git remote update
git rebase upstream/master
提交您的更改 (确保您的提交说明清晰完整)。
git commit -a
整理提交,然后将您的提交推送到复刻的存储库。
git push origin your_branch
创建 Pull request 合并请求。
后续在修改更改后,一般应强制推送到复刻的存储库:
git push origin your_branch -f
请确保 PR 对应有相应的 Issue。请参阅 将拉取请求链接到议题 - GitHub Docs 。
创建 PR 后,社区会有成员帮助 Review,Review 通过之后,PR 将会合并到主仓库,相应的 Issue 会被关闭。
我们使用 Issue 和 Pull Requests 作为跟踪器:
如果您发现新的 Bug,想要新功能或提出新当建议,您可以在 GitHub 上创建 Issue ,请按照 Issue 模板中的准则进行操作。
如果您在文档中发现拼写错误,或者发现代码中存在可以进行微小的优化的地方,您可以无需创建 Issue, 直接提交一个 PR。
如果您想贡献,请先创建一个新的 PR。 如果您的 PR 包含较大的更改,请写详细描述有关其设计和使用的信息。
注意
单个 PR 不应太大。如果需要进行重大更改,最好将更改分开到一些 PR。
所有 PR 应进行良好的审查。一些原则:
易用性。更改不应对软件的易用性产生负面作用。
第三方代码尽量保持原状。PDFPatcher 命名空间外的代码为第三方代码,如非必要尽量不修改。
PR 经过 Approve 之后会由 Committer 负责合并,在合并的时候,Committer 可以对提交说明进行修改。 在合并时一般使用 Rebase and merge。对于大型多人协助的 PR,使用 Merge 进行合并,在合并之前通过 Rebase 修正提交。
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。