General Requirement

Red Hat is committing to using conscious language in their products as
Chris Wright declared [1] and it is described in our SST planning [2].
Therefore, NST projects should commit to this too. I am compiling the
different projects in which changes would be required. The idea is to
identify the needed efforts and to create a plan to promote inclusive
language on each project.

Goals

• Identify the existing problematic terms in the different projects.
• For each problematic term, the project needs to find a good replacement.
• Replace the following terms from the git branches, internal code, APIs and documentation (these are problematic terms already identified with good replacements):
  • "master/slave" by "controller/port"
  • "whitelist/blacklist" by "allowlist/denylist"
  • On git branches: "master" to "main"
• Do not break any existing feature/API when doing these changes.

Roadmap

The roadmap needs to be defined for each project. But this is the general roadmap for the Networking SST.

1. Contact all the projects under the Networking SST umbrella
2. Work with each project to identify the existing problematic terms and reach an agreement on what replacement to use.
3. Modify the git branch name from "master" to “main”.
4. Modify the API exposed to the users. The old API must be tagged as
   deprecated but not removed. A warning should be raised in case the
   deprecated API is being used.
5. Modify the internal code to use conscious language.
6. Contact documentation team to do the needed changes.

References

[1] https://www.redhat.com/en/blog/making-open-source-more-inclusive-eradicating-problematic-language
[2] https://docs.google.com/document/d/1CY0I1oZzTNNk-SAH0bRduh1o9rwv-33XZSJv8WYxHcE/edit?usp=sharing