rabbitmq-website icon indicating copy to clipboard operation
rabbitmq-website copied to clipboard

Phase 2 - Make updates for Inclusive Language in OSS RabbitMQ Docs - Update Code instances, then update docs

Open pstack2021 opened this issue 2 years ago • 6 comments

Make terminology changes for inclusive language in code instances. When the code updates are complete, update the RabbitMQ OSS docs to reflect these changes.

The details of the changes that need to happen are here: https://source.vmware.com/portal/pages/global-marketing/terminology-changes

The list of changes that need to happen in the code are tracked in this google doc which I composed when I was completing the PHASE 1 updates, I have shared this doc with @michaelklishin @acogoluegnes, and @dyozie.

For more details of the PHASE 1 part of the project which is now complete, see https://github.com/rabbitmq/rabbitmq-website/issues/1502

pstack2021 avatar Nov 03 '22 21:11 pstack2021

The CLI part of this will ship in 3.11.4. We decided to not change the internally used names as they will go away after 4.0 because so will classic mirrored queues and related features.

michaelklishin avatar Nov 13 '22 16:11 michaelklishin

Hmm, rabbitmq-plugins commands would still need updating even then.

michaelklishin avatar Nov 13 '22 16:11 michaelklishin

The CLI part of this will ship in 3.11.4. We decided to not change the internally used names as they will go away after 4.0 because so will classic mirrored queues and related features.

Hi @michaelklishin can you expand it a bit more on what you mean by this?

In Summary, are you saying the OSS RabbitMQ 4.0 release will handle a lot of these inclusive language updates by default due to the fact that the internally used names will "go away" then as will CMQ and related features.

What do you mean by "go away" above, are they simply being removed/replaced/renamed?

We probably need an open issue to check/verify the state of inclusive language on the OSS doc site after the above has happened to see if there are additional updates we need to make in code that haven't been covered by the above??

Please let me know your thoughts. Many thanks, Paula.

pstack2021 avatar Nov 17 '22 11:11 pstack2021

In 4.0, classic mirrored queues will be removed (classic unmirrored queues will not), and so on will all the unfortunate terminology they use. All of those are internal changes.

When 3.12 ships we should be able to switch all CLI examples that mention "slaves" to use "mirrors" because of #6399.

michaelklishin avatar Nov 17 '22 11:11 michaelklishin

ok thanks @michaelklishin so we probably need to do an assessment after 3.12 and 4.0 ships to check what is left with regard to code updates for inclusive language, agree?

pstack2021 avatar Nov 21 '22 14:11 pstack2021

@pstack2021 yup

michaelklishin avatar Nov 21 '22 18:11 michaelklishin