在2019年9月，我们宣布了
对 GitHub 作为 Jenkins 插件站点文档来源的支持。
感谢 Zbynek Konecny 和 Olivier Vernin 以及其他贡献者，
现在可以将插件文档直接存储在插件储存库中，而不是 Jenkins Wiki 中，对于插件维护者和 Jenkins 基础设施团队来说，这在过去是很难维护的。
这篇博文可能对插件维护者和那些想为 Jenkins 文档做贡献的人来说很有趣。
我将描述如何将插件文档迁移到 GitHub 并获得如下页面:
为什么？
通过使用插件的 GitHub 仓库存储文档，
插件维护者可以遵循 文档即代码 的方法，将文档更改作为 pull request 的一部分，这样就不会忘记文档的后续工作。
它还提供了一个 review 文档更改以及增加文档贡献者的认可度的机会，尤其是如果 story 与 Release Drafter 结合。
不幸的是，在2019年9月之前，GitHub 文档的使用引起了一些问题。
首先，许多插件维护者已经将他们的文档迁移到 GitHub，这导致了文档的碎片化（Wiki、GitHub、jenkins.io）。
为了解决这个问题，插件维护者仍然需要使用重定向来维护存根 Wiki 页面，
用户不得不花一些时间来找出真正的文档在哪里。
通过支持 GitHub 作为文档来源，我们允许维护者逐步淘汰插件 Wiki 页面，同时改善用户体验。
现在进行迁移还有更紧迫的原因……
如果你订阅了开发者邮件列表，
你可能还看到了 R. Tyler Croy 关于 Jenkins Wiki 稳定性问题的声明，
并将其设置为只读，作为稳定实例的临时措施
(邮件列表主题)。
虽然功能后来部分恢复了，
基础架构团队一致认为，我们应该逐渐转向替代解决方案。
例子
自从9月份宣布以来，超过50个插件已经从 Wiki 迁移到 GitHub。
几个例子：
配置即代码插件
Mailer 插件
Gradle 插件
角色策略插件
如何为你的插件启用 GitHub 文档？
将文档从 Wiki 转换到 GitHub Asciidoc 或 Markdown 格式，如果你还没有做。
它可以用半自动的方式完成，请看这里的指南。
更改 pom.xml...