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