2019年9月,我们宣布对github作为jenkin必威国际有限公司s插件插件插件文档的支持支持。感谢感谢感谢感谢感谢感谢感谢感谢感谢感谢感谢感谢感谢感谢感谢感谢感谢感谢感谢感谢感谢感谢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...