2016年,Jenkins必威国际有限公司社区决定改变项目中的非包容性术语。在Jenkins 2.0中,“奴隶”一词已被弃用,取而代之的是“代理人”。必威国际有限公司2020年7月,我们也会采用用“控制器”代替“主”,并弃用“白名单/黑名单”。在许多地方,旧的术语仍然需要被替换。

我们邀请Jenkin必威国际有限公司s贡献者和用户加入我们,并参与清理Jenkins文档、Web和CLI界面、代码库和所有其他事件。我们想用新的术语来代替过时的术语:“controller”、“agent”、“allowlist”、“denylist”和“main”作为分支名称。请在评论中提出任何问题。

贡献

我们将感谢任何贡献!有许多相对简单的贡献,任何人都可以做出,无论是否编写代码。其中一些只需要几分钟,我们非常欢迎在我们的社区做出这样的贡献。

不写代码的帮助

  • 报告问题。如果你在Jenkins UI或我们的网站上看到了什么,请必威国际有限公司不要犹豫,在各自的组件问题跟踪(Jenkins Jira或GitHub问题)中报告它。
  • 审查pull请求,并向其他贡献者提供反馈。看到项目在GitHub上对于一些链接。
  • 在你的公司或社区内传播新的Jenkins术语。必威国际有限公司纠正内部文件和资料
  • 联系使用旧术语的内容创造者和所有者,特别是新发布的博客、视频和其他材料。在你的消息中,参考博客文章并要求更新。
    • 消息的例子:感谢你传播关于詹金斯的信息和知识!必威国际有限公司作为社区,我们不支持使用已弃用的术语术语,我们也不推广此类内容。如果你能更新你的帖子就太好了。更多详情请访问此页面:https://community.jenkins.io/t/jenkins-必威国际有限公司terminology-cleanup-initiative-coordination/180

Newcomer-friendly问题

  • 修复詹金斯·吉拉的新人友好问题必威国际有限公司
  • 清理插件内置文档和Jenkins存储库中的文档必威国际有限公司
    • GitHub查询:“奴隶”“奴隶”“必威国际有限公司詹金斯大师”
    • 如果你在做这些任务,在大多数情况下,你可以使用GitHub web界面来编辑文件和提交拉请求。
    • 注意,对于Jenkins控制器子实体来说,选择术语并不总是简单的。必威国际有限公司例如,Jenkibs控制器上的“主”节点现在被称为“内置节点”,而不是“控制器节点”。
      看到本节对于所选的项
  • 修复母语国际化问题,包括嵌入式文档。您可以找到一些语言的推荐术语在这里
  • 清理Javadoc和代码注释
  • 清理文档截图。它可能需要启动实例并在屏幕截图上重新生成布局

其他问题联系

完整的范围

相对较小的变化,不需要经验。

  • 必威国际有限公司詹金斯文档(必威国际有限公司jenkins.io-提交拉请求与修复
  • 内置插件文档和Web UI
  • 本地化文件——其他语言中弃用的术语等效物
  • 第三方更好
  • 任何不属于公共AP或持久性模式的代码:私有方法、局部变量、注释等。

可能影响兼容性的重要更改:

  • REST API端点——出于兼容性的原因,旧的端点应该保留
  • JCasC/JobDSL/Pipeline的符号——出于兼容性原因,旧的符号应该保留
  • 类名和可行的API。保持二进制兼容性可能需要付出巨大的努力
  • 重命名库,清理Jenkins中作为上游依赖项使用的库必威国际有限公司
  • 插件站点和更新中心:更新插件标签和过滤器,以避免引用https://plugins.必威国际有限公司jenkins.io/.这可能需要引入对标签同义词的支持
  • 插件id -一些插件,如SSH构建代理插件仍然包含过时的插件id。没有Jenkins核心和工具的大规模更新是不可能阻止的必威国际有限公司
  • 将存储库中的默认分支从“master”更改为“main”。它可能需要更新机器人设置,GitHub应用程序和动作。看到改变默认分支- GitHub Docs
  • 等。

参考文献

1像

在同一主题中,我将提出一个包含最新术语表参考的JEP。建议JEP在表中包含最新的术语状态。拉请求#368·jenkinsci/jep·GitHub必威国际有限公司如果有人想和我合作,请告诉我,我很高兴能有一些帮助来写它: slight_smile:

1像

包容性命名现在正式列在倡导和拓展SIG页面上:宣传和推广

在CloudBees的UI术语更新期间,Thierry做了一个工具来搜索图片中的文字(OCR),因为它是开源的,我在这里分享的任何人都可以使用它GitHub - twasyl /图片搜索
这对于寻找需要更新的截图非常有用。谢谢亨利眨眼:!!

2喜欢

这似乎是更新日志对于一些Jenkins用户来说,用他们之前声明的地必威国际有限公司方替换“master”可能不是100%:

节点(主)

看到S / O -必威国际有限公司在2.307+版本升级后,詹金斯丢失了“主”节点标签

这个名字有点反直觉,文档称它为“内置节点,而不是"内置的“节点或”(内置)”节点。

在一个之前的消息,这只是“内置的
想法吗?

我认为我们应该稍微改变changelog条目的措辞,并包括一个链接到连接到管理监视器上的“了解更多”页面。行政监察员说:

“了解更多”页面上包含的链接提供了更多的细节。我认为我们应该在更新日志中加入一个链接到“了解更多”页面。

下一个LTS版本的升级指南也可以包括更多的细节,但这将不会提供近3个月

我已经提交了·Pull Request #4518·jenkins-infra/jenkins添加链接到内置节点迁移文档。必威国际有限公司io·GitHub < / t作为一个提议的拉请求添加更多的文本和更多的链接到更新日志条目。

1像

有趣的反馈,谢谢。第一个更新日志条目应该是关于UI标签的;而第二个(加上管理监视器)处理特定标签以及如何解决它。

让我有点惊讶的是,用户这么快就遇到了这个问题,而没有显示管理监视器,也没有经过标签自动完成。

我想知道标签表单验证是否应该显式地调用如果没有为内置节点手动设置,则使用标签。

1像

FTR该主题被列为2021年Hacktoberfest的特色项目。我把它从2020年版挪过来了。@ajard@MarkEWaite如果需要的话,你能检查描述并提出修改建议吗?Hacktoberfest

1像