Uploaded image for project: 'Jenkins'
  1. Jenkins
  2. JENKINS-65398

Terminology update for master, whitelist, blacklist

    XMLWordPrintable

    Details

    • Type: Epic
    • Status: Open (View Workflow)
    • Priority: Minor
    • Resolution: Unresolved
    • Component/s: core
    • Labels:
      None
    • Epic Name:
      Terminology update for master, slave, whitelist, blacklist
    • Similar Issues:

      Description

      In July 2020 we  adopted the "controller" term instead of "master", and deprecated the "whitelist/blacklist" terms. There are many places where the old terminology still needs to be replaced.

      For example, deprecated term can be:

      • in UI files, like *.jelly, *.groovy, *.html
      • in logs that ends up in job console, or Jenkins console
      • in cli output
      • HTTP API
      • Documentation, README, code comments

      Changing master in other context (like git or any scm master branch) is out of scope of this Epic.
      We invite contributors to join us and participate in cleaning up Jenkins documentation, Web and CLI interfaces, and the codebase.

      Deprecated term To be replaced by
      master built-in when used for node/label
      controller (for everything else)
      slave agent (please use https://issues.jenkins.io/browse/JENKINS-42816 )
      whitelist allowlist (default but can be adapted to context)
      blacklist denylist or blocklist (default but can be adapted to context)

      If you are working on slave/agent replacement please use https://issues.jenkins.io/browse/JENKINS-42816

        Attachments

          Issue Links

            Activity

            ajard A. Jard created issue -
            ajard A. Jard made changes -
            Field Original Value New Value
            Epic Child JENKINS-58979 [ 201328 ]
            ajard A. Jard made changes -
            Link This issue relates to JENKINS-42816 [ JENKINS-42816 ]
            Show
            ajard A. Jard added a comment - - edited Some PR linked to this Epic https://github.com/jenkinsci/credentials-plugin/pull/197 – merged https://github.com/jenkinsci/gradle-plugin/pull/115 – merged https://github.com/jenkinsci/junit-plugin/pull/268 – merged https://github.com/jenkinsci/kubernetes-plugin/pull/981 – merged https://github.com/jenkinsci/git-plugin/pull/1077 – merged https://github.com/jenkinsci/config-file-provider-plugin/pull/117 – merged https://github.com/jenkinsci/ldap-plugin/pull/89 – merged https://github.com/jenkinsci/metrics-plugin/pull/98 – merged https://github.com/jenkinsci/credentials-binding-plugin/pull/128 – merged https://github.com/jenkinsci/ssh-slaves-plugin/pull/226 – merged https://github.com/jenkinsci/support-core-plugin/pull/227 – merged https://github.com/jenkinsci/windows-slaves-plugin/pull/32 – merged https://github.com/jenkinsci/docker-build-publish-plugin/pull/60 https://github.com/jenkinsci/promoted-builds-plugin/pull/152
            Hide
            oleg_nenashev Oleg Nenashev added a comment -

            Should we keep agent cleanup in JENKINS-42816  ?

             

            Show
            oleg_nenashev Oleg Nenashev added a comment - Should we keep agent cleanup in  JENKINS-42816   ?  
            Hide
            ajard A. Jard added a comment -

            Oleg Nenashev I have no strong opinion, I don't think that there are PRs with agent renaming only (it's often mainly controller and some agent in the way), but we can link both Epic maybe. But I can update the description to redirect to the other Epic for agent (I like to see the mapping all old word -> new word in one place).

            Show
            ajard A. Jard added a comment - Oleg Nenashev I have no strong opinion, I don't think that there are PRs with agent renaming only (it's often mainly controller and some agent in the way), but we can link both Epic maybe. But I can update the description to redirect to the other Epic for agent (I like to see the mapping all old word -> new word in one place).
            ajard A. Jard made changes -
            Description In 2016, the Jenkins community started changing the potentially offensive terminology within the project. The "slave" term was deprecated and replaced by "agent".

            In July 2020 we also [adopted|https://cd.foundation/blog/2020/08/25/jenkins-terminology-changes/] the "controller" term instead of "master", and deprecated the "whitelist/blacklist" terms. There are many places where the old terminology still needs to be replaced.

            For example, deprecated term can be:
             * in UI files, like *.jelly, *.groovy, *.html
             * in logs that ends up in job console, or Jenkins console
             * in cli output
             * HTTP API
             * Documentation, README, code comments

            Changing master in other context (like git or any scm master branch) is out of scope of this Epic.
            We invite contributors to join us and participate in cleaning up Jenkins documentation, Web and CLI interfaces, and the codebase.


            ||Deprecated term||To be replaced by||
            |master|controller|
            |slave|agent|
            |whitelist|allowlist|
            |blacklist|denylist|
            In July 2020 we  [adopted|https://cd.foundation/blog/2020/08/25/jenkins-terminology-changes/] the "controller" term instead of "master", and deprecated the "whitelist/blacklist" terms. There are many places where the old terminology still needs to be replaced.

            For example, deprecated term can be:
             * in UI files, like *.jelly, *.groovy, *.html
             * in logs that ends up in job console, or Jenkins console
             * in cli output
             * HTTP API
             * Documentation, README, code comments

            Changing master in other context (like git or any scm master branch) is out of scope of this Epic.
             We invite contributors to join us and participate in cleaning up Jenkins documentation, Web and CLI interfaces, and the codebase.

            ||Deprecated term||To be replaced by||
            |master|controller|
            |slave|agent (please use https://issues.jenkins.io/browse/JENKINS-42816 )|
            |whitelist|allowlist|
            |blacklist|denylist|

            If you are working on slave/agent replacement please use https://issues.jenkins.io/browse/JENKINS-42816
            ajard A. Jard made changes -
            Summary Terminology update for master, slave, whitelist, blacklist Terminology update for master, whitelist, blacklist
            Hide
            ajard A. Jard added a comment -

            I have updated the description with a link to Agent renaming Epic, I hope it fits all needs

            Show
            ajard A. Jard added a comment - I have updated the description with a link to Agent renaming Epic, I hope it fits all needs
            danielbeck Daniel Beck made changes -
            Description In July 2020 we  [adopted|https://cd.foundation/blog/2020/08/25/jenkins-terminology-changes/] the "controller" term instead of "master", and deprecated the "whitelist/blacklist" terms. There are many places where the old terminology still needs to be replaced.

            For example, deprecated term can be:
             * in UI files, like *.jelly, *.groovy, *.html
             * in logs that ends up in job console, or Jenkins console
             * in cli output
             * HTTP API
             * Documentation, README, code comments

            Changing master in other context (like git or any scm master branch) is out of scope of this Epic.
             We invite contributors to join us and participate in cleaning up Jenkins documentation, Web and CLI interfaces, and the codebase.

            ||Deprecated term||To be replaced by||
            |master|controller|
            |slave|agent (please use https://issues.jenkins.io/browse/JENKINS-42816 )|
            |whitelist|allowlist|
            |blacklist|denylist|

            If you are working on slave/agent replacement please use https://issues.jenkins.io/browse/JENKINS-42816
            In July 2020 we  [adopted|https://cd.foundation/blog/2020/08/25/jenkins-terminology-changes/] the "controller" term instead of "master", and deprecated the "whitelist/blacklist" terms. There are many places where the old terminology still needs to be replaced.

            For example, deprecated term can be:
             * in UI files, like *.jelly, *.groovy, *.html
             * in logs that ends up in job console, or Jenkins console
             * in cli output
             * HTTP API
             * Documentation, README, code comments

            Changing master in other context (like git or any scm master branch) is out of scope of this Epic.
             We invite contributors to join us and participate in cleaning up Jenkins documentation, Web and CLI interfaces, and the codebase.
            ||Deprecated term||To be replaced by||
            |master|TBD (for built-in node/label) and controller (for everything else)|
            |slave|agent (please use https://issues.jenkins.io/browse/JENKINS-42816 )|
            |whitelist|allowlist|
            |blacklist|denylist|

            If you are working on slave/agent replacement please use https://issues.jenkins.io/browse/JENKINS-42816
            ajard A. Jard made changes -
            Description In July 2020 we  [adopted|https://cd.foundation/blog/2020/08/25/jenkins-terminology-changes/] the "controller" term instead of "master", and deprecated the "whitelist/blacklist" terms. There are many places where the old terminology still needs to be replaced.

            For example, deprecated term can be:
             * in UI files, like *.jelly, *.groovy, *.html
             * in logs that ends up in job console, or Jenkins console
             * in cli output
             * HTTP API
             * Documentation, README, code comments

            Changing master in other context (like git or any scm master branch) is out of scope of this Epic.
             We invite contributors to join us and participate in cleaning up Jenkins documentation, Web and CLI interfaces, and the codebase.
            ||Deprecated term||To be replaced by||
            |master|TBD (for built-in node/label) and controller (for everything else)|
            |slave|agent (please use https://issues.jenkins.io/browse/JENKINS-42816 )|
            |whitelist|allowlist|
            |blacklist|denylist|

            If you are working on slave/agent replacement please use https://issues.jenkins.io/browse/JENKINS-42816
            In July 2020 we  [adopted|https://cd.foundation/blog/2020/08/25/jenkins-terminology-changes/] the "controller" term instead of "master", and deprecated the "whitelist/blacklist" terms. There are many places where the old terminology still needs to be replaced.

            For example, deprecated term can be:
             * in UI files, like *.jelly, *.groovy, *.html
             * in logs that ends up in job console, or Jenkins console
             * in cli output
             * HTTP API
             * Documentation, README, code comments

            Changing master in other context (like git or any scm master branch) is out of scope of this Epic.
             We invite contributors to join us and participate in cleaning up Jenkins documentation, Web and CLI interfaces, and the codebase.
            ||Deprecated term||To be replaced by||
            |master|TBD (for built-in node/label) and controller (for everything else)|
            |slave|agent (please use https://issues.jenkins.io/browse/JENKINS-42816 )|
            |whitelist|allowlist (default but can be adapted to context)|
            |blacklist|denylist (default but can be adapted to context)|

            If you are working on slave/agent replacement please use https://issues.jenkins.io/browse/JENKINS-42816
            ajard A. Jard made changes -
            Description In July 2020 we  [adopted|https://cd.foundation/blog/2020/08/25/jenkins-terminology-changes/] the "controller" term instead of "master", and deprecated the "whitelist/blacklist" terms. There are many places where the old terminology still needs to be replaced.

            For example, deprecated term can be:
             * in UI files, like *.jelly, *.groovy, *.html
             * in logs that ends up in job console, or Jenkins console
             * in cli output
             * HTTP API
             * Documentation, README, code comments

            Changing master in other context (like git or any scm master branch) is out of scope of this Epic.
             We invite contributors to join us and participate in cleaning up Jenkins documentation, Web and CLI interfaces, and the codebase.
            ||Deprecated term||To be replaced by||
            |master|TBD (for built-in node/label) and controller (for everything else)|
            |slave|agent (please use https://issues.jenkins.io/browse/JENKINS-42816 )|
            |whitelist|allowlist (default but can be adapted to context)|
            |blacklist|denylist (default but can be adapted to context)|

            If you are working on slave/agent replacement please use https://issues.jenkins.io/browse/JENKINS-42816
            In July 2020 we  [adopted|https://cd.foundation/blog/2020/08/25/jenkins-terminology-changes/] the "controller" term instead of "master", and deprecated the "whitelist/blacklist" terms. There are many places where the old terminology still needs to be replaced.

            For example, deprecated term can be:
             * in UI files, like *.jelly, *.groovy, *.html
             * in logs that ends up in job console, or Jenkins console
             * in cli output
             * HTTP API
             * Documentation, README, code comments

            Changing master in other context (like git or any scm master branch) is out of scope of this Epic.
             We invite contributors to join us and participate in cleaning up Jenkins documentation, Web and CLI interfaces, and the codebase.
            ||Deprecated term||To be replaced by||
            |master|TBD (for built-in node/label) and controller (for everything else)|
            |slave|agent (please use https://issues.jenkins.io/browse/JENKINS-42816 )|
            |whitelist|allowlist (default but can be adapted to context)|
            |blacklist|denylist or blocklist (default but can be adapted to context)|

            If you are working on slave/agent replacement please use https://issues.jenkins.io/browse/JENKINS-42816
            pierrebtz Pierre Beitz made changes -
            Epic Child JENKINS-65435 [ 211108 ]
            Hide
            kerogers Kenneth Rogers added a comment -
            Show
            kerogers Kenneth Rogers added a comment - Another PR for this epic https://github.com/jenkinsci/workflow-api-plugin/pull/147
            Show
            amuniz Antonio Muñiz added a comment - One more https://github.com/jenkinsci/pubsub-light-plugin/pull/35
            vlatombe Vincent Latombe made changes -
            Description In July 2020 we  [adopted|https://cd.foundation/blog/2020/08/25/jenkins-terminology-changes/] the "controller" term instead of "master", and deprecated the "whitelist/blacklist" terms. There are many places where the old terminology still needs to be replaced.

            For example, deprecated term can be:
             * in UI files, like *.jelly, *.groovy, *.html
             * in logs that ends up in job console, or Jenkins console
             * in cli output
             * HTTP API
             * Documentation, README, code comments

            Changing master in other context (like git or any scm master branch) is out of scope of this Epic.
             We invite contributors to join us and participate in cleaning up Jenkins documentation, Web and CLI interfaces, and the codebase.
            ||Deprecated term||To be replaced by||
            |master|TBD (for built-in node/label) and controller (for everything else)|
            |slave|agent (please use https://issues.jenkins.io/browse/JENKINS-42816 )|
            |whitelist|allowlist (default but can be adapted to context)|
            |blacklist|denylist or blocklist (default but can be adapted to context)|

            If you are working on slave/agent replacement please use https://issues.jenkins.io/browse/JENKINS-42816
            In July 2020 we  [adopted|https://cd.foundation/blog/2020/08/25/jenkins-terminology-changes/] the "controller" term instead of "master", and deprecated the "whitelist/blacklist" terms. There are many places where the old terminology still needs to be replaced.

            For example, deprecated term can be:
             * in UI files, like *.jelly, *.groovy, *.html
             * in logs that ends up in job console, or Jenkins console
             * in cli output
             * HTTP API
             * Documentation, README, code comments

            Changing master in other context (like git or any scm master branch) is out of scope of this Epic.
             We invite contributors to join us and participate in cleaning up Jenkins documentation, Web and CLI interfaces, and the codebase.
            ||Deprecated term||To be replaced by||
            |master|built-in when used for node/label
            controller (for everything else)|
            |slave|agent (please use https://issues.jenkins.io/browse/JENKINS-42816 )|
            |whitelist|allowlist (default but can be adapted to context)|
            |blacklist|denylist or blocklist (default but can be adapted to context)|

            If you are working on slave/agent replacement please use https://issues.jenkins.io/browse/JENKINS-42816
            Show
            vlatombe Vincent Latombe added a comment - https://github.com/jenkinsci/workflow-durable-task-step-plugin/pull/160 https://github.com/jenkinsci/copyartifact-plugin/pull/138 https://github.com/jenkinsci/command-launcher-plugin/pull/19
            Hide
            ikedam ikedam added a comment -

            Rewriting changelogs may feel strange for maintainers.
            (I actually once considered to finish the review with "Request changes" in copyartifact-plugin)

            It would be helpful to clarify that it's expected to update even changelogs as the Jenkins community policy
            though it's finally up to maintainers whether they update changelogs.
            (I believe it's the community policy according to https://github.com/jenkins-infra/jenkins.io/pull/4302 .)

            Show
            ikedam ikedam added a comment - Rewriting changelogs may feel strange for maintainers. (I actually once considered to finish the review with "Request changes" in copyartifact-plugin) It would be helpful to clarify that it's expected to update even changelogs as the Jenkins community policy though it's finally up to maintainers whether they update changelogs. (I believe it's the community policy according to https://github.com/jenkins-infra/jenkins.io/pull/4302 .)
            Hide
            ajard A. Jard added a comment -

            I don't rewrite changelogs, I feel that we shouldn't change the past but maybe I am wrong. I don't have strong opinion, not sure that there is an community agreement.

            Show
            ajard A. Jard added a comment - I don't rewrite changelogs, I feel that we shouldn't change the past but maybe I am wrong. I don't have strong opinion, not sure that there is an community agreement.
            Hide
            ikedam ikedam added a comment -

            I want a guideline for cases where plugins contain translations that maintainer cannot maintain.

            • Create tickets for those translations.
            • Leave TODO file or TODO comments in files.
            • Remove translations supposed to contain terminologies that should be update.

            reference: https://github.com/jenkinsci/copyartifact-plugin/pull/138/commits/7bbbafa5ad81e70d1a404e2eb88977c31602ed3d#r639029081

            Show
            ikedam ikedam added a comment - I want a guideline for cases where plugins contain translations that maintainer cannot maintain. Create tickets for those translations. Leave TODO file or TODO comments in files. Remove translations supposed to contain terminologies that should be update. reference: https://github.com/jenkinsci/copyartifact-plugin/pull/138/commits/7bbbafa5ad81e70d1a404e2eb88977c31602ed3d#r639029081

              People

              Assignee:
              Unassigned Unassigned
              Reporter:
              ajard A. Jard
              Votes:
              0 Vote for this issue
              Watchers:
              6 Start watching this issue

                Dates

                Created:
                Updated: