[jira] [Commented] (AMQ-7514) Replace racially charged terms throughout source code, comments and documentation

2021-07-12 Thread Matt Pavlovich (Jira)


[ 
https://issues.apache.org/jira/browse/AMQ-7514?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17379279#comment-17379279
 ] 

Matt Pavlovich commented on AMQ-7514:
-

I've created sub-tasks to break-up the effort and I think it should help 
delineate the conversation as well. There just isn't a lot of problematic 
terminology in the AMQ 5 code base to begin with, and most of the methods are 
slated for removal. I'm not opposed to aligning terms, but I do not think we 
should align to some terminology that does not have any technical backing in 
either code base.

I recommend we define a clear consensus around the precedent in play here. What 
is the boundary for terminology alignment? Are we going to rename 'acceptor' to 
'transportConnector' in Artemis? Or vice-versa? At this time, the gap in 
terminology alignment between the two brokers is very wide. There are more 
fundamental user-facing terms that aren't aligned.

Are we in agreement that the terminology alignment goal is only for shared 
storage, replicated storage, broker status, and future terms?

>From the original mailing list thread, the point I'd like to emphasize is that 
>you can have combinations of replication and shared storage in an 
>architecture. I think it is important to have that separated and that the 
>terms were derived from there. If we overload 'primary' than it requires more 
>training on the user's part to understand.

[~michael.andre.pearce] can you help me understand the value of assigning 
meaning to a node? This feels backwards from the industry trend to move away 
from designating nodes for a certain purpose. ActiveMQ 5 does not have that 
today in any technical capacity.

[~jbertram] there is not currently a configured state, and do not understand 
why we'd want to introduce that.

Perhaps it makes more sense to push down the 'tag' term down to the persistence 
layer? Attempting to canonicalizing these terms is loaded with gotchas and 
further need for translation by users. Those terms can be designated by the 
persistence layer and the technology used by that persistence layer. So if 
someone is using ZK, those terms can be used 'as-is'. Same for 'BK', custom, 
in-house, etc. 

As for the broker itself, it is only 'active' or 'standby'. In either case it 
represents the _state_ of the broker based on signals from the persistence 
adapter layer. Thoughts?


> Replace racially charged terms throughout source code, comments and 
> documentation
> -
>
> Key: AMQ-7514
> URL: https://issues.apache.org/jira/browse/AMQ-7514
> Project: ActiveMQ
>  Issue Type: Task
>Reporter: Bruce Snyder
>Assignee: Matt Pavlovich
>Priority: Major
>  Time Spent: 4.5h
>  Remaining Estimate: 0h
>
> Given the racial charged nature of certain terms in today's world, we must 
> pull together to create a plan for changing any such terms throughout all the 
> ActiveMQ projects and in the git repos themselves.
>   
>  Example: [https://activemq.apache.org/masterslave.html]
>   
>  Here are just a few terms that should be changed: * The following terms are 
> being targeted for change:
>  * 
>  ** 'master' and 'slave' should be replaced with the terms 'live' and 'backup'
>  ** 'whitelist' and 'blacklist' should be replaced with the terms 'allowlist' 
> and 'denylist'
>  * Rename all the git 'master' branches to the term 'main'
> Proposal notes from activemq-dev mailing list
> Phase 1: 
> 1. Deprecate terms such as ‘master’ and ’slave
> 2. log.warn any configuration change notifications
> 3. Provide compatibility under the covers for deprecated terms
> 4. Provide any openwire compatibility changes b/w ActiveMQ 5 and Artemis
> 5. Notify users in an announcement and provide a conversion HOWTO
> Phase 2: 
> 1. Remove terminology as part of a major or minor release (SEMVER where ‘y’ 
> in ‘x.y.z’ is minor version number)
> New terms:
> a. For shared storage: ‘active’ and ’standby’
> b. For replication: ‘primary’ and ‘replica'
> c. For 'white list' and 'blacklist': 'allow list' and 'deny list'
> For example:
> ‘master’ -> ‘active’
> ’slave’ -> ’standby'



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Commented] (AMQ-7514) Replace racially charged terms throughout source code, comments and documentation

2021-07-09 Thread Jira


[ 
https://issues.apache.org/jira/browse/AMQ-7514?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17378237#comment-17378237
 ] 

Étienne Hossack commented on AMQ-7514:
--

[~cshannon] shifting to the dev list makes sense to me, especially given the 
scope of the decision is widened to include Artemis. Unless someone objects, I 
will summarize and link the discussion later today in a message to the dev list?

> Replace racially charged terms throughout source code, comments and 
> documentation
> -
>
> Key: AMQ-7514
> URL: https://issues.apache.org/jira/browse/AMQ-7514
> Project: ActiveMQ
>  Issue Type: Task
>Reporter: Bruce Snyder
>Priority: Major
>  Time Spent: 4h
>  Remaining Estimate: 0h
>
> Given the racial charged nature of certain terms in today's world, we must 
> pull together to create a plan for changing any such terms throughout all the 
> ActiveMQ projects and in the git repos themselves.
>   
>  Example: [https://activemq.apache.org/masterslave.html]
>   
>  Here are just a few terms that should be changed: * The following terms are 
> being targeted for change:
>  * 
>  ** 'master' and 'slave' should be replaced with the terms 'live' and 'backup'
>  ** 'whitelist' and 'blacklist' should be replaced with the terms 'allowlist' 
> and 'denylist'
>  * Rename all the git 'master' branches to the term 'main'
> Proposal notes from activemq-dev mailing list
> Phase 1: 
> 1. Deprecate terms such as ‘master’ and ’slave
> 2. log.warn any configuration change notifications
> 3. Provide compatibility under the covers for deprecated terms
> 4. Provide any openwire compatibility changes b/w ActiveMQ 5 and Artemis
> 5. Notify users in an announcement and provide a conversion HOWTO
> Phase 2: 
> 1. Remove terminology as part of a major or minor release (SEMVER where ‘y’ 
> in ‘x.y.z’ is minor version number)
> New terms:
> a. For shared storage: ‘active’ and ’standby’
> b. For replication: ‘primary’ and ‘replica'
> c. For 'white list' and 'blacklist': 'allow list' and 'deny list'
> For example:
> ‘master’ -> ‘active’
> ’slave’ -> ’standby'



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Commented] (AMQ-7514) Replace racially charged terms throughout source code, comments and documentation

2021-07-09 Thread Justin Bertram (Jira)


[ 
https://issues.apache.org/jira/browse/AMQ-7514?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17378231#comment-17378231
 ] 

Justin Bertram commented on AMQ-7514:
-

bq. The scope of this ticket is a terminology change for the ActiveMQ code 
base...

I appreciate that this is in the AMQ Jira project, but it is an issue that 
affects both the classic and Artemis brokers.

bq. ActiveMQ does not have the concept around node meaning when it comes to 
primary/standby (formerly master/slave).

I understand that and I certainly grant that it's not exactly the same as the 
semantics in Artemis. However, even in the case of ActiveMQ classic you 
configure the brokers as _something_ and that something needs a name. Since it 
is indeterminate maybe it's called "a primary/standby pair" (i.e. a combination 
of the new nouns). Then at runtime one is the primary and one is the standby 
based on who won the race to acquire the lock. Either way, there is a 
configured state and a runtime condition that must be clearly defined and this 
definition should use terms which are consistent across brokers.

> Replace racially charged terms throughout source code, comments and 
> documentation
> -
>
> Key: AMQ-7514
> URL: https://issues.apache.org/jira/browse/AMQ-7514
> Project: ActiveMQ
>  Issue Type: Task
>Reporter: Bruce Snyder
>Priority: Major
>  Time Spent: 4h
>  Remaining Estimate: 0h
>
> Given the racial charged nature of certain terms in today's world, we must 
> pull together to create a plan for changing any such terms throughout all the 
> ActiveMQ projects and in the git repos themselves.
>   
>  Example: [https://activemq.apache.org/masterslave.html]
>   
>  Here are just a few terms that should be changed: * The following terms are 
> being targeted for change:
>  * 
>  ** 'master' and 'slave' should be replaced with the terms 'live' and 'backup'
>  ** 'whitelist' and 'blacklist' should be replaced with the terms 'allowlist' 
> and 'denylist'
>  * Rename all the git 'master' branches to the term 'main'
> Proposal notes from activemq-dev mailing list
> Phase 1: 
> 1. Deprecate terms such as ‘master’ and ’slave
> 2. log.warn any configuration change notifications
> 3. Provide compatibility under the covers for deprecated terms
> 4. Provide any openwire compatibility changes b/w ActiveMQ 5 and Artemis
> 5. Notify users in an announcement and provide a conversion HOWTO
> Phase 2: 
> 1. Remove terminology as part of a major or minor release (SEMVER where ‘y’ 
> in ‘x.y.z’ is minor version number)
> New terms:
> a. For shared storage: ‘active’ and ’standby’
> b. For replication: ‘primary’ and ‘replica'
> c. For 'white list' and 'blacklist': 'allow list' and 'deny list'
> For example:
> ‘master’ -> ‘active’
> ’slave’ -> ’standby'



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Commented] (AMQ-7514) Replace racially charged terms throughout source code, comments and documentation

2021-07-09 Thread Christopher L. Shannon (Jira)


[ 
https://issues.apache.org/jira/browse/AMQ-7514?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17378215#comment-17378215
 ] 

Christopher L. Shannon commented on AMQ-7514:
-

I agree more so with going the primary/secondary or leader/follower etc route 
vs active/passive because of the reasons specified by Gary and Michael. The 
most important thing is consistency so whatever is done needs to be the same 
across ActiveMQ 5.x and Artemis to avoid confusion.

Also, I think this conversation should probably be held on the dev list going 
forward so we can discuss and have an official vote on terms we want to use 
going forward.

> Replace racially charged terms throughout source code, comments and 
> documentation
> -
>
> Key: AMQ-7514
> URL: https://issues.apache.org/jira/browse/AMQ-7514
> Project: ActiveMQ
>  Issue Type: Task
>Reporter: Bruce Snyder
>Priority: Major
>  Time Spent: 4h
>  Remaining Estimate: 0h
>
> Given the racial charged nature of certain terms in today's world, we must 
> pull together to create a plan for changing any such terms throughout all the 
> ActiveMQ projects and in the git repos themselves.
>   
>  Example: [https://activemq.apache.org/masterslave.html]
>   
>  Here are just a few terms that should be changed: * The following terms are 
> being targeted for change:
>  * 
>  ** 'master' and 'slave' should be replaced with the terms 'live' and 'backup'
>  ** 'whitelist' and 'blacklist' should be replaced with the terms 'allowlist' 
> and 'denylist'
>  * Rename all the git 'master' branches to the term 'main'
> Proposal notes from activemq-dev mailing list
> Phase 1: 
> 1. Deprecate terms such as ‘master’ and ’slave
> 2. log.warn any configuration change notifications
> 3. Provide compatibility under the covers for deprecated terms
> 4. Provide any openwire compatibility changes b/w ActiveMQ 5 and Artemis
> 5. Notify users in an announcement and provide a conversion HOWTO
> Phase 2: 
> 1. Remove terminology as part of a major or minor release (SEMVER where ‘y’ 
> in ‘x.y.z’ is minor version number)
> New terms:
> a. For shared storage: ‘active’ and ’standby’
> b. For replication: ‘primary’ and ‘replica'
> c. For 'white list' and 'blacklist': 'allow list' and 'deny list'
> For example:
> ‘master’ -> ‘active’
> ’slave’ -> ’standby'



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Commented] (AMQ-7514) Replace racially charged terms throughout source code, comments and documentation

2021-07-09 Thread Domenico Francesco Bruscino (Jira)


[ 
https://issues.apache.org/jira/browse/AMQ-7514?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17378141#comment-17378141
 ] 

Domenico Francesco Bruscino commented on AMQ-7514:
--

I would also vote for 'primary', it seems to match all requirements described 
above.




> Replace racially charged terms throughout source code, comments and 
> documentation
> -
>
> Key: AMQ-7514
> URL: https://issues.apache.org/jira/browse/AMQ-7514
> Project: ActiveMQ
>  Issue Type: Task
>Reporter: Bruce Snyder
>Priority: Major
>  Time Spent: 4h
>  Remaining Estimate: 0h
>
> Given the racial charged nature of certain terms in today's world, we must 
> pull together to create a plan for changing any such terms throughout all the 
> ActiveMQ projects and in the git repos themselves.
>   
>  Example: [https://activemq.apache.org/masterslave.html]
>   
>  Here are just a few terms that should be changed: * The following terms are 
> being targeted for change:
>  * 
>  ** 'master' and 'slave' should be replaced with the terms 'live' and 'backup'
>  ** 'whitelist' and 'blacklist' should be replaced with the terms 'allowlist' 
> and 'denylist'
>  * Rename all the git 'master' branches to the term 'main'
> Proposal notes from activemq-dev mailing list
> Phase 1: 
> 1. Deprecate terms such as ‘master’ and ’slave
> 2. log.warn any configuration change notifications
> 3. Provide compatibility under the covers for deprecated terms
> 4. Provide any openwire compatibility changes b/w ActiveMQ 5 and Artemis
> 5. Notify users in an announcement and provide a conversion HOWTO
> Phase 2: 
> 1. Remove terminology as part of a major or minor release (SEMVER where ‘y’ 
> in ‘x.y.z’ is minor version number)
> New terms:
> a. For shared storage: ‘active’ and ’standby’
> b. For replication: ‘primary’ and ‘replica'
> c. For 'white list' and 'blacklist': 'allow list' and 'deny list'
> For example:
> ‘master’ -> ‘active’
> ’slave’ -> ’standby'



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Commented] (AMQ-7514) Replace racially charged terms throughout source code, comments and documentation

2021-07-09 Thread Gary Tully (Jira)


[ 
https://issues.apache.org/jira/browse/AMQ-7514?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17378061#comment-17378061
 ] 

Gary Tully commented on AMQ-7514:
-

my vote would be to replace 'master' with 'primary'.

primary can have many meanings and be both a noun or adjective[1]. I think this 
looseness helps here.
[1] https://www.google.com/search?q=primary+definition

it does not imply secondary but can work with it, similarly with backup it can 
work, or with replica too. they can all work with a 'primary'. Even in a single 
broker world it can be the 'primary'. 
I think there could even be multiple primary brokers (that are peers) and  
there can be sharding or sharing or whatever, it won't effect that they are 
primary (important) brokers. 
The primary has exclusive access to a journal. 




> Replace racially charged terms throughout source code, comments and 
> documentation
> -
>
> Key: AMQ-7514
> URL: https://issues.apache.org/jira/browse/AMQ-7514
> Project: ActiveMQ
>  Issue Type: Task
>Reporter: Bruce Snyder
>Priority: Major
>  Time Spent: 4h
>  Remaining Estimate: 0h
>
> Given the racial charged nature of certain terms in today's world, we must 
> pull together to create a plan for changing any such terms throughout all the 
> ActiveMQ projects and in the git repos themselves.
>   
>  Example: [https://activemq.apache.org/masterslave.html]
>   
>  Here are just a few terms that should be changed: * The following terms are 
> being targeted for change:
>  * 
>  ** 'master' and 'slave' should be replaced with the terms 'live' and 'backup'
>  ** 'whitelist' and 'blacklist' should be replaced with the terms 'allowlist' 
> and 'denylist'
>  * Rename all the git 'master' branches to the term 'main'
> Proposal notes from activemq-dev mailing list
> Phase 1: 
> 1. Deprecate terms such as ‘master’ and ’slave
> 2. log.warn any configuration change notifications
> 3. Provide compatibility under the covers for deprecated terms
> 4. Provide any openwire compatibility changes b/w ActiveMQ 5 and Artemis
> 5. Notify users in an announcement and provide a conversion HOWTO
> Phase 2: 
> 1. Remove terminology as part of a major or minor release (SEMVER where ‘y’ 
> in ‘x.y.z’ is minor version number)
> New terms:
> a. For shared storage: ‘active’ and ’standby’
> b. For replication: ‘primary’ and ‘replica'
> c. For 'white list' and 'blacklist': 'allow list' and 'deny list'
> For example:
> ‘master’ -> ‘active’
> ’slave’ -> ’standby'



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Commented] (AMQ-7514) Replace racially charged terms throughout source code, comments and documentation

2021-07-09 Thread Michael Andre Pearce (Jira)


[ 
https://issues.apache.org/jira/browse/AMQ-7514?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17377910#comment-17377910
 ] 

Michael Andre Pearce commented on AMQ-7514:
---

[~ehossack] i appreciate that. This said just because something works somewhere 
else, within a given context doesn't mean it automatically works else where. 
Like wise i really would like to avoid renaming the meanings of everything. 

The word "active" has existing terminology and meaning, along side what master 
/ slave means especially in Artemis. And want to avoid overusing that word to 
mean different and new things.

I would really like to see/hear alternative proposals from yourselves, rather 
than simply pushing only the nomenclature you use at AWS. As i keep calling 
out, there is many alternatives and well adopted alternatives to Master / Slave 
terminology, lets explore and propose some alternatives, that do not clash with 
existing terminology and naming used / historic ones, to avoid confusions. 

I'm open to alternatives, im just a bit against s/master/active/g in our code 
bases, due to existing meanings and historic usage within the project.

> Replace racially charged terms throughout source code, comments and 
> documentation
> -
>
> Key: AMQ-7514
> URL: https://issues.apache.org/jira/browse/AMQ-7514
> Project: ActiveMQ
>  Issue Type: Task
>Reporter: Bruce Snyder
>Priority: Major
>  Time Spent: 3h 50m
>  Remaining Estimate: 0h
>
> Given the racial charged nature of certain terms in today's world, we must 
> pull together to create a plan for changing any such terms throughout all the 
> ActiveMQ projects and in the git repos themselves.
>   
>  Example: [https://activemq.apache.org/masterslave.html]
>   
>  Here are just a few terms that should be changed: * The following terms are 
> being targeted for change:
>  * 
>  ** 'master' and 'slave' should be replaced with the terms 'live' and 'backup'
>  ** 'whitelist' and 'blacklist' should be replaced with the terms 'allowlist' 
> and 'denylist'
>  * Rename all the git 'master' branches to the term 'main'
> Proposal notes from activemq-dev mailing list
> Phase 1: 
> 1. Deprecate terms such as ‘master’ and ’slave
> 2. log.warn any configuration change notifications
> 3. Provide compatibility under the covers for deprecated terms
> 4. Provide any openwire compatibility changes b/w ActiveMQ 5 and Artemis
> 5. Notify users in an announcement and provide a conversion HOWTO
> Phase 2: 
> 1. Remove terminology as part of a major or minor release (SEMVER where ‘y’ 
> in ‘x.y.z’ is minor version number)
> New terms:
> a. For shared storage: ‘active’ and ’standby’
> b. For replication: ‘primary’ and ‘replica'
> c. For 'white list' and 'blacklist': 'allow list' and 'deny list'
> For example:
> ‘master’ -> ‘active’
> ’slave’ -> ’standby'



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Commented] (AMQ-7514) Replace racially charged terms throughout source code, comments and documentation

2021-07-09 Thread Jira


[ 
https://issues.apache.org/jira/browse/AMQ-7514?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17377886#comment-17377886
 ] 

Étienne Hossack commented on AMQ-7514:
--

[~michael.andre.pearce], my opinions of the nomenclature expressed here are 
purely my own. My callout of what AWS uses was simply a data point to 
illustrate that it is viable to use Active/Standby and cause no confusion.
I would definitely prefer a decision come collaboratively in the spirit of the 
Apache community. [~tetlucas] and myself are passionate about both inclusivity 
and open source, and wanted to help drive the conversation through the phases 
of this plan. If that’s being taken as Amazon MQ trying to dictate anything 
then we would be more than happy to recuse ourselves from this conversation and 
let the community at large decide how to proceed.

> Replace racially charged terms throughout source code, comments and 
> documentation
> -
>
> Key: AMQ-7514
> URL: https://issues.apache.org/jira/browse/AMQ-7514
> Project: ActiveMQ
>  Issue Type: Task
>Reporter: Bruce Snyder
>Priority: Major
>  Time Spent: 3h 50m
>  Remaining Estimate: 0h
>
> Given the racial charged nature of certain terms in today's world, we must 
> pull together to create a plan for changing any such terms throughout all the 
> ActiveMQ projects and in the git repos themselves.
>   
>  Example: [https://activemq.apache.org/masterslave.html]
>   
>  Here are just a few terms that should be changed: * The following terms are 
> being targeted for change:
>  * 
>  ** 'master' and 'slave' should be replaced with the terms 'live' and 'backup'
>  ** 'whitelist' and 'blacklist' should be replaced with the terms 'allowlist' 
> and 'denylist'
>  * Rename all the git 'master' branches to the term 'main'
> Proposal notes from activemq-dev mailing list
> Phase 1: 
> 1. Deprecate terms such as ‘master’ and ’slave
> 2. log.warn any configuration change notifications
> 3. Provide compatibility under the covers for deprecated terms
> 4. Provide any openwire compatibility changes b/w ActiveMQ 5 and Artemis
> 5. Notify users in an announcement and provide a conversion HOWTO
> Phase 2: 
> 1. Remove terminology as part of a major or minor release (SEMVER where ‘y’ 
> in ‘x.y.z’ is minor version number)
> New terms:
> a. For shared storage: ‘active’ and ’standby’
> b. For replication: ‘primary’ and ‘replica'
> c. For 'white list' and 'blacklist': 'allow list' and 'deny list'
> For example:
> ‘master’ -> ‘active’
> ’slave’ -> ’standby'



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Commented] (AMQ-7514) Replace racially charged terms throughout source code, comments and documentation

2021-07-09 Thread Michael Andre Pearce (Jira)


[ 
https://issues.apache.org/jira/browse/AMQ-7514?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17377869#comment-17377869
 ] 

Michael Andre Pearce commented on AMQ-7514:
---

But the point is there is that history and also your rephrase for artemis is a 
bit of a WTF still. Simply lets just avoid the issue,  by using different 
terminology, theres plenty of available replacement words..

As noted both [~ehossack] and [~tetlucas] i understand per comment on the PR 
you raised [~ehossack] you both work at AWS and active is used to replace 
master at AWS, but i really dont want a specific vendor's preference to naming 
their services dictate what an Apache project gets to call their, it is an 
Apache project NOT an AWS one..

> Replace racially charged terms throughout source code, comments and 
> documentation
> -
>
> Key: AMQ-7514
> URL: https://issues.apache.org/jira/browse/AMQ-7514
> Project: ActiveMQ
>  Issue Type: Task
>Reporter: Bruce Snyder
>Priority: Major
>  Time Spent: 3h 50m
>  Remaining Estimate: 0h
>
> Given the racial charged nature of certain terms in today's world, we must 
> pull together to create a plan for changing any such terms throughout all the 
> ActiveMQ projects and in the git repos themselves.
>   
>  Example: [https://activemq.apache.org/masterslave.html]
>   
>  Here are just a few terms that should be changed: * The following terms are 
> being targeted for change:
>  * 
>  ** 'master' and 'slave' should be replaced with the terms 'live' and 'backup'
>  ** 'whitelist' and 'blacklist' should be replaced with the terms 'allowlist' 
> and 'denylist'
>  * Rename all the git 'master' branches to the term 'main'
> Proposal notes from activemq-dev mailing list
> Phase 1: 
> 1. Deprecate terms such as ‘master’ and ’slave
> 2. log.warn any configuration change notifications
> 3. Provide compatibility under the covers for deprecated terms
> 4. Provide any openwire compatibility changes b/w ActiveMQ 5 and Artemis
> 5. Notify users in an announcement and provide a conversion HOWTO
> Phase 2: 
> 1. Remove terminology as part of a major or minor release (SEMVER where ‘y’ 
> in ‘x.y.z’ is minor version number)
> New terms:
> a. For shared storage: ‘active’ and ’standby’
> b. For replication: ‘primary’ and ‘replica'
> c. For 'white list' and 'blacklist': 'allow list' and 'deny list'
> For example:
> ‘master’ -> ‘active’
> ’slave’ -> ’standby'



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Commented] (AMQ-7514) Replace racially charged terms throughout source code, comments and documentation

2021-07-09 Thread Jira


[ 
https://issues.apache.org/jira/browse/AMQ-7514?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17377867#comment-17377867
 ] 

Lucas Tétreault commented on AMQ-7514:
--

{quote}The point is alignment with the replacement of the words Master and 
Slave for both Brokers.
{quote}
Maybe the deployment modes are different enough that aligning the terminology 
doesn't make sense? 

> Replace racially charged terms throughout source code, comments and 
> documentation
> -
>
> Key: AMQ-7514
> URL: https://issues.apache.org/jira/browse/AMQ-7514
> Project: ActiveMQ
>  Issue Type: Task
>Reporter: Bruce Snyder
>Priority: Major
>  Time Spent: 3h 50m
>  Remaining Estimate: 0h
>
> Given the racial charged nature of certain terms in today's world, we must 
> pull together to create a plan for changing any such terms throughout all the 
> ActiveMQ projects and in the git repos themselves.
>   
>  Example: [https://activemq.apache.org/masterslave.html]
>   
>  Here are just a few terms that should be changed: * The following terms are 
> being targeted for change:
>  * 
>  ** 'master' and 'slave' should be replaced with the terms 'live' and 'backup'
>  ** 'whitelist' and 'blacklist' should be replaced with the terms 'allowlist' 
> and 'denylist'
>  * Rename all the git 'master' branches to the term 'main'
> Proposal notes from activemq-dev mailing list
> Phase 1: 
> 1. Deprecate terms such as ‘master’ and ’slave
> 2. log.warn any configuration change notifications
> 3. Provide compatibility under the covers for deprecated terms
> 4. Provide any openwire compatibility changes b/w ActiveMQ 5 and Artemis
> 5. Notify users in an announcement and provide a conversion HOWTO
> Phase 2: 
> 1. Remove terminology as part of a major or minor release (SEMVER where ‘y’ 
> in ‘x.y.z’ is minor version number)
> New terms:
> a. For shared storage: ‘active’ and ’standby’
> b. For replication: ‘primary’ and ‘replica'
> c. For 'white list' and 'blacklist': 'allow list' and 'deny list'
> For example:
> ‘master’ -> ‘active’
> ’slave’ -> ’standby'



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Commented] (AMQ-7514) Replace racially charged terms throughout source code, comments and documentation

2021-07-09 Thread Jira


[ 
https://issues.apache.org/jira/browse/AMQ-7514?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17377864#comment-17377864
 ] 

Étienne Hossack commented on AMQ-7514:
--

Regarding your concerns [~michael.andre.pearce] for ActiveMQ 5.17+ as those are 
the ones currently in question, since leveldb has been removed, I don't think 
we have to worry about that confusion! Yes it could change in the future, but 
the discussion is for right now, and we can't really predict the future it's a 
good path forward in my opinion.

For Artemis I hear your concerns about states and designations. So rather than 
introduce something new, maybe keeping the current live/backup as is used in 
the docs is best? The config can reference Active/Replica or whichever as 
needed to determine the intent of the node. I'll reiterate that "primary" or 
"leader" are moderately confusing in the context of multiple HA pairs within an 
Artemis cluster. I don't believe any of the terms in the linked article are any 
clearer.

Your sentence "When an Active node fails the Replica takes over, but if you 
have fail back to Active configured when the Active node is restarted the 
Active Replica will failback to the Active node and it will become Active 
again" can be written as:

"When an Active node fails the Replica takes over [accepting traffic]. If you 
have configured your broker with the 'allow-failback' option, when the original 
Active is restarted, the Replica will resume replication and the Active node 
will accept traffic."

I believe the confusion in your sentence comes from the capitalization and 
referencing "failback" as concept before defining what that actually means in 
the context of this HA pair.

In general I believe a broker user/documentation reader does not need to be 
aware of a formal state in this context, and the implicit meaning in a sentence 
can suffice (serving traffic).

> Replace racially charged terms throughout source code, comments and 
> documentation
> -
>
> Key: AMQ-7514
> URL: https://issues.apache.org/jira/browse/AMQ-7514
> Project: ActiveMQ
>  Issue Type: Task
>Reporter: Bruce Snyder
>Priority: Major
>  Time Spent: 3h 50m
>  Remaining Estimate: 0h
>
> Given the racial charged nature of certain terms in today's world, we must 
> pull together to create a plan for changing any such terms throughout all the 
> ActiveMQ projects and in the git repos themselves.
>   
>  Example: [https://activemq.apache.org/masterslave.html]
>   
>  Here are just a few terms that should be changed: * The following terms are 
> being targeted for change:
>  * 
>  ** 'master' and 'slave' should be replaced with the terms 'live' and 'backup'
>  ** 'whitelist' and 'blacklist' should be replaced with the terms 'allowlist' 
> and 'denylist'
>  * Rename all the git 'master' branches to the term 'main'
> Proposal notes from activemq-dev mailing list
> Phase 1: 
> 1. Deprecate terms such as ‘master’ and ’slave
> 2. log.warn any configuration change notifications
> 3. Provide compatibility under the covers for deprecated terms
> 4. Provide any openwire compatibility changes b/w ActiveMQ 5 and Artemis
> 5. Notify users in an announcement and provide a conversion HOWTO
> Phase 2: 
> 1. Remove terminology as part of a major or minor release (SEMVER where ‘y’ 
> in ‘x.y.z’ is minor version number)
> New terms:
> a. For shared storage: ‘active’ and ’standby’
> b. For replication: ‘primary’ and ‘replica'
> c. For 'white list' and 'blacklist': 'allow list' and 'deny list'
> For example:
> ‘master’ -> ‘active’
> ’slave’ -> ’standby'



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Commented] (AMQ-7514) Replace racially charged terms throughout source code, comments and documentation

2021-07-09 Thread Michael Andre Pearce (Jira)


[ 
https://issues.apache.org/jira/browse/AMQ-7514?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17377861#comment-17377861
 ] 

Michael Andre Pearce commented on AMQ-7514:
---

The point is alignment with the replacement of the words Master and Slave for 
both Brokers. Theres no point having one terminology for one and another for 
the other. Like wise Classic has had the concepts of replicated setup before, 
and tbh in future i could always see another attempt to try re-add, so master 
slave for the node designation even in classic would come back.

> Replace racially charged terms throughout source code, comments and 
> documentation
> -
>
> Key: AMQ-7514
> URL: https://issues.apache.org/jira/browse/AMQ-7514
> Project: ActiveMQ
>  Issue Type: Task
>Reporter: Bruce Snyder
>Priority: Major
>  Time Spent: 3h 50m
>  Remaining Estimate: 0h
>
> Given the racial charged nature of certain terms in today's world, we must 
> pull together to create a plan for changing any such terms throughout all the 
> ActiveMQ projects and in the git repos themselves.
>   
>  Example: [https://activemq.apache.org/masterslave.html]
>   
>  Here are just a few terms that should be changed: * The following terms are 
> being targeted for change:
>  * 
>  ** 'master' and 'slave' should be replaced with the terms 'live' and 'backup'
>  ** 'whitelist' and 'blacklist' should be replaced with the terms 'allowlist' 
> and 'denylist'
>  * Rename all the git 'master' branches to the term 'main'
> Proposal notes from activemq-dev mailing list
> Phase 1: 
> 1. Deprecate terms such as ‘master’ and ’slave
> 2. log.warn any configuration change notifications
> 3. Provide compatibility under the covers for deprecated terms
> 4. Provide any openwire compatibility changes b/w ActiveMQ 5 and Artemis
> 5. Notify users in an announcement and provide a conversion HOWTO
> Phase 2: 
> 1. Remove terminology as part of a major or minor release (SEMVER where ‘y’ 
> in ‘x.y.z’ is minor version number)
> New terms:
> a. For shared storage: ‘active’ and ’standby’
> b. For replication: ‘primary’ and ‘replica'
> c. For 'white list' and 'blacklist': 'allow list' and 'deny list'
> For example:
> ‘master’ -> ‘active’
> ’slave’ -> ’standby'



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Commented] (AMQ-7514) Replace racially charged terms throughout source code, comments and documentation

2021-07-09 Thread Jira


[ 
https://issues.apache.org/jira/browse/AMQ-7514?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17377860#comment-17377860
 ] 

Lucas Tétreault commented on AMQ-7514:
--

[~michael.andre.pearce] and[~jbertram]

It seems to me like this sentence from Justin neatly summarizes why you are 
both opposed to the "active/standby" terminology. 
{quote} If we don't have clear ways to discuss both the configured state and 
runtime condition of the nodes it will be difficult to properly document and 
troubleshoot.
{quote}
 
If that is the case, then I don't really understand the argument since Classic 
doesn't have the concept of "configured state" as Matt said. We really are just 
talking about the current runtime condition of the nodes aren't we? 
 

> Replace racially charged terms throughout source code, comments and 
> documentation
> -
>
> Key: AMQ-7514
> URL: https://issues.apache.org/jira/browse/AMQ-7514
> Project: ActiveMQ
>  Issue Type: Task
>Reporter: Bruce Snyder
>Priority: Major
>  Time Spent: 3h 50m
>  Remaining Estimate: 0h
>
> Given the racial charged nature of certain terms in today's world, we must 
> pull together to create a plan for changing any such terms throughout all the 
> ActiveMQ projects and in the git repos themselves.
>   
>  Example: [https://activemq.apache.org/masterslave.html]
>   
>  Here are just a few terms that should be changed: * The following terms are 
> being targeted for change:
>  * 
>  ** 'master' and 'slave' should be replaced with the terms 'live' and 'backup'
>  ** 'whitelist' and 'blacklist' should be replaced with the terms 'allowlist' 
> and 'denylist'
>  * Rename all the git 'master' branches to the term 'main'
> Proposal notes from activemq-dev mailing list
> Phase 1: 
> 1. Deprecate terms such as ‘master’ and ’slave
> 2. log.warn any configuration change notifications
> 3. Provide compatibility under the covers for deprecated terms
> 4. Provide any openwire compatibility changes b/w ActiveMQ 5 and Artemis
> 5. Notify users in an announcement and provide a conversion HOWTO
> Phase 2: 
> 1. Remove terminology as part of a major or minor release (SEMVER where ‘y’ 
> in ‘x.y.z’ is minor version number)
> New terms:
> a. For shared storage: ‘active’ and ’standby’
> b. For replication: ‘primary’ and ‘replica'
> c. For 'white list' and 'blacklist': 'allow list' and 'deny list'
> For example:
> ‘master’ -> ‘active’
> ’slave’ -> ’standby'



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Commented] (AMQ-7514) Replace racially charged terms throughout source code, comments and documentation

2021-07-09 Thread Michael Andre Pearce (Jira)


[ 
https://issues.apache.org/jira/browse/AMQ-7514?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17377842#comment-17377842
 ] 

Michael Andre Pearce commented on AMQ-7514:
---

I disagree [~ehossack] and [~mattrpav]. And fully agree with [~jbertram]

 

We actually had addtional terms for master and slave when we had leveldb with 
its "pure master slave" and like wise back with replicated kaha db, the broker 
service master and slave actually was around the nodes role, and then it became 
active when it took over. To this point we actually still have the slave in 
what we call a passiveSlave in the. broker service where the Slave is still not 
activated.

 

Regarding Replication in Artemis again, we have states, this is determined 
master or slave, which you actively define the node type in the configuration, 
with either the node becoming "Active", we even have the concepts of failback 
to master for predominate master setups.

 

For this reason i think we really need to avoid the words "Active" or "Slave" 
for defining a node, we use it to mean the current state of a node, if we start 
overloading the term as you suggest we will end up with phrases like "When 
an Active node fails the Replica takes over, but if you have fail back to 
Active configured when the Active node is restarted the Active Replica will 
failback to the Active node and it will become Active again" Like seriously 
WTF.. its a terminology disaster.

 

There is plenty of alternatives to the words Master/Slave that avoid the word 
"Active" so lets simply avoid the problem..

[https://www.theserverside.com/opinion/Master-slave-terminology-alternatives-you-can-use-right-now]

 

 

> Replace racially charged terms throughout source code, comments and 
> documentation
> -
>
> Key: AMQ-7514
> URL: https://issues.apache.org/jira/browse/AMQ-7514
> Project: ActiveMQ
>  Issue Type: Task
>Reporter: Bruce Snyder
>Priority: Major
>  Time Spent: 3h 50m
>  Remaining Estimate: 0h
>
> Given the racial charged nature of certain terms in today's world, we must 
> pull together to create a plan for changing any such terms throughout all the 
> ActiveMQ projects and in the git repos themselves.
>   
>  Example: [https://activemq.apache.org/masterslave.html]
>   
>  Here are just a few terms that should be changed: * The following terms are 
> being targeted for change:
>  * 
>  ** 'master' and 'slave' should be replaced with the terms 'live' and 'backup'
>  ** 'whitelist' and 'blacklist' should be replaced with the terms 'allowlist' 
> and 'denylist'
>  * Rename all the git 'master' branches to the term 'main'
> Proposal notes from activemq-dev mailing list
> Phase 1: 
> 1. Deprecate terms such as ‘master’ and ’slave
> 2. log.warn any configuration change notifications
> 3. Provide compatibility under the covers for deprecated terms
> 4. Provide any openwire compatibility changes b/w ActiveMQ 5 and Artemis
> 5. Notify users in an announcement and provide a conversion HOWTO
> Phase 2: 
> 1. Remove terminology as part of a major or minor release (SEMVER where ‘y’ 
> in ‘x.y.z’ is minor version number)
> New terms:
> a. For shared storage: ‘active’ and ’standby’
> b. For replication: ‘primary’ and ‘replica'
> c. For 'white list' and 'blacklist': 'allow list' and 'deny list'
> For example:
> ‘master’ -> ‘active’
> ’slave’ -> ’standby'



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Commented] (AMQ-7514) Replace racially charged terms throughout source code, comments and documentation

2021-07-08 Thread Jira


[ 
https://issues.apache.org/jira/browse/AMQ-7514?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17377801#comment-17377801
 ] 

Étienne Hossack commented on AMQ-7514:
--

I am mostly in agreement with [~mattrpav] here, but I don't think it's 
unreasonable to consider the problem holistically. Let's outline the state of 
the world:



ActiveMQ
 * Single Node
 * 2 nodes one actively serving traffic, one waiting to grab the lock
 * Network of brokers

Artemis
 * Single node
 * 2 nodes configured with an HA policy of shared storage, one waiting to grab 
the lock
 * A cluster wherein nodes are configured to actively serve traffic, or with an 
HA policy of replica, continuously replicating a node that is serving traffic
 * A node which is configured to mirror another node
 * A federation of nodes

Within this context, I think we can rule out NoB and federation as each of 
these connected nodes could also coincide with any of the other HA policies.

In the context of a single node, the instance is just actively servicing 
traffic so we could refrain from terminology or just call it active.

In the context of shared storage at any given point one node is actively 
serving requests, and another is standing by waiting to serve them. Both 
Active/Passive and Active/Standby could describe this. However I would argue 
that the alternatives "follower", "secondary", "backup", and "replica" are not 
applicable because this pairing has (reasons respective to the alternatives 
ordering): no context that it is not a leader, no awareness of another node, no 
knowledge it's a backup, and is not replicating state. I personally think 
standby is a better fit because, as one would imagine say a soldier or a 
firefighter, the second node is constantly checking the lock and waiting to 
start serving traffic rather than passively waiting to be told it must start.

In the context of a node within a cluster, with a replicated HA policy, since 
the one node is continuously replicating traffic, I would think the clearest 
terminology would be a "replica". The alternatives, "secondary" might be 
confusing in a cluster with say 6 nodes, 3 of which are active. Follower/backup 
could be used, but I personally think that follower is better paired with 
leader (still confusing in a 6 node cluster) and although backup still might 
apply, but since there's established terminology of HA policy replica.

In the context of a mirror, given that its specific purpose is in disaster 
recovery rather than immediate recovery via replication, I would think that 
either backup, or recovery would apply. Although this has no configuration the 
docs could be adjusted.

For all of the above Artemis states, I think that Active continues to best 
describe a node that is currently serving traffic, assuming the intent here is 
to align terminology across the two engines (an alternative to this would of 
course be to continue using "live" in Artemis, but promote that to a top-level 
concept in config). I think adding in an extra term to describe the combined 
state (e.g. active replica) only adds confusion. One can simply say the 
"now-active replica node", or "current active node". Even the docs say things 
like, "In case of "shared disk", simply restart the original live server and 
kill the new live server. You can do this by killing the process itself." -> 
"In case of "shared disk", simply restart the original -live- active server, 
and -kill- stop the new -live- active server. You can do this by -killing- 
stopping the process itself"

 

So to summarize, what I'd propose:

ActiveMQ
 * Active/Standby

Artemis
 * Active/Standby via shared storage
 * Active/Replica via network replication
 * Active/Recovery via AMQP mirror

> Replace racially charged terms throughout source code, comments and 
> documentation
> -
>
> Key: AMQ-7514
> URL: https://issues.apache.org/jira/browse/AMQ-7514
> Project: ActiveMQ
>  Issue Type: Task
>Reporter: Bruce Snyder
>Priority: Major
>  Time Spent: 3h 50m
>  Remaining Estimate: 0h
>
> Given the racial charged nature of certain terms in today's world, we must 
> pull together to create a plan for changing any such terms throughout all the 
> ActiveMQ projects and in the git repos themselves.
>   
>  Example: [https://activemq.apache.org/masterslave.html]
>   
>  Here are just a few terms that should be changed: * The following terms are 
> being targeted for change:
>  * 
>  ** 'master' and 'slave' should be replaced with the terms 'live' and 'backup'
>  ** 'whitelist' and 'blacklist' should be replaced with the terms 'allowlist' 
> and 'denylist'
>  * Rename all the git 'master' branches to the term 'main'
> Proposal notes from activemq-dev mailing list
> Phase 1: 
> 1. Deprecate terms such as ‘master’ 

[jira] [Commented] (AMQ-7514) Replace racially charged terms throughout source code, comments and documentation

2021-07-08 Thread Jira


[ 
https://issues.apache.org/jira/browse/AMQ-7514?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17377781#comment-17377781
 ] 

Jan Šmucr commented on AMQ-7514:


[~ehossack] +1

I have no clue how the term blacklist relates to skin color. The origins of the 
term do not refer to a race in any means. Should the "black" part be an issue, 
let's get rid of "yellow" and "red" too, as these are another colors widely 
used in relation to skin color.

Removing such terms from our lives does not solve any real world issue. Should 
anyone be offended by finding "blacklist" being used as a technical term, they 
would definitely find something else to be offended by if that got replaced. 
Self-consciousness targeted therapy might work better. 

At my job we solve issues bringing improvements that move us forward, so that 
in the end we can say *_doing this brought us this very benefit_*. This task 
lacks anything alike. Will it result in more diverse community, or is it just a 
political issue with no real impact?

> Replace racially charged terms throughout source code, comments and 
> documentation
> -
>
> Key: AMQ-7514
> URL: https://issues.apache.org/jira/browse/AMQ-7514
> Project: ActiveMQ
>  Issue Type: Task
>Reporter: Bruce Snyder
>Priority: Major
>  Time Spent: 3h 50m
>  Remaining Estimate: 0h
>
> Given the racial charged nature of certain terms in today's world, we must 
> pull together to create a plan for changing any such terms throughout all the 
> ActiveMQ projects and in the git repos themselves.
>   
>  Example: [https://activemq.apache.org/masterslave.html]
>   
>  Here are just a few terms that should be changed: * The following terms are 
> being targeted for change:
>  * 
>  ** 'master' and 'slave' should be replaced with the terms 'live' and 'backup'
>  ** 'whitelist' and 'blacklist' should be replaced with the terms 'allowlist' 
> and 'denylist'
>  * Rename all the git 'master' branches to the term 'main'
> Proposal notes from activemq-dev mailing list
> Phase 1: 
> 1. Deprecate terms such as ‘master’ and ’slave
> 2. log.warn any configuration change notifications
> 3. Provide compatibility under the covers for deprecated terms
> 4. Provide any openwire compatibility changes b/w ActiveMQ 5 and Artemis
> 5. Notify users in an announcement and provide a conversion HOWTO
> Phase 2: 
> 1. Remove terminology as part of a major or minor release (SEMVER where ‘y’ 
> in ‘x.y.z’ is minor version number)
> New terms:
> a. For shared storage: ‘active’ and ’standby’
> b. For replication: ‘primary’ and ‘replica'
> c. For 'white list' and 'blacklist': 'allow list' and 'deny list'
> For example:
> ‘master’ -> ‘active’
> ’slave’ -> ’standby'



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Commented] (AMQ-7514) Replace racially charged terms throughout source code, comments and documentation

2021-07-08 Thread Matt Pavlovich (Jira)


[ 
https://issues.apache.org/jira/browse/AMQ-7514?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=1736#comment-1736
 ] 

Matt Pavlovich commented on AMQ-7514:
-

The scope of this ticket is a terminology change for the ActiveMQ code base and 
other concepts related to replication/backup/etc would be new features.

I disagree with [~jbertram] comment. ActiveMQ does not have the concept around 
node meaning when it comes to primary/standby (formerly master/slave). There is 
simply a race condition to grab a lock and no other meaning is placed on a 
node. It is simple-- a node is 'primary' when it obtains the lock. It is a 
point in time and nothing more. Adding any additional terms does not clarify 
what is happening or add value.





> Replace racially charged terms throughout source code, comments and 
> documentation
> -
>
> Key: AMQ-7514
> URL: https://issues.apache.org/jira/browse/AMQ-7514
> Project: ActiveMQ
>  Issue Type: Task
>Reporter: Bruce Snyder
>Priority: Major
>  Time Spent: 3h 50m
>  Remaining Estimate: 0h
>
> Given the racial charged nature of certain terms in today's world, we must 
> pull together to create a plan for changing any such terms throughout all the 
> ActiveMQ projects and in the git repos themselves.
>   
>  Example: [https://activemq.apache.org/masterslave.html]
>   
>  Here are just a few terms that should be changed: * The following terms are 
> being targeted for change:
>  * 
>  ** 'master' and 'slave' should be replaced with the terms 'live' and 'backup'
>  ** 'whitelist' and 'blacklist' should be replaced with the terms 'allowlist' 
> and 'denylist'
>  * Rename all the git 'master' branches to the term 'main'
> Proposal notes from activemq-dev mailing list
> Phase 1: 
> 1. Deprecate terms such as ‘master’ and ’slave
> 2. log.warn any configuration change notifications
> 3. Provide compatibility under the covers for deprecated terms
> 4. Provide any openwire compatibility changes b/w ActiveMQ 5 and Artemis
> 5. Notify users in an announcement and provide a conversion HOWTO
> Phase 2: 
> 1. Remove terminology as part of a major or minor release (SEMVER where ‘y’ 
> in ‘x.y.z’ is minor version number)
> New terms:
> a. For shared storage: ‘active’ and ’standby’
> b. For replication: ‘primary’ and ‘replica'
> c. For 'white list' and 'blacklist': 'allow list' and 'deny list'
> For example:
> ‘master’ -> ‘active’
> ’slave’ -> ’standby'



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Commented] (AMQ-7514) Replace racially charged terms throughout source code, comments and documentation

2021-07-08 Thread Justin Bertram (Jira)


[ 
https://issues.apache.org/jira/browse/AMQ-7514?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17377740#comment-17377740
 ] 

Justin Bertram commented on AMQ-7514:
-

I think the master/slave renaming will be the most tricky as we'll need a 
handful of new terms and these terms should be consistent across both classic 
and Artemis.

First, we at least need 2 new _nouns_. These will represent the configured 
state of the nodes in both the shared storage and replicated use-cases (e.g. 
primary, backup, replica, etc.).

Second, we need 2 _adjectives_ to describe the state of the nodes (e.g. active, 
passive, live, dead, etc.). This is so we can accurately describe the runtime 
condition of a node (e.g. active backup, passive primary, live replica, etc.).

If we don't have clear ways to discuss both the configured state and runtime 
condition of the nodes it will be difficult to properly document and 
troubleshoot.

> Replace racially charged terms throughout source code, comments and 
> documentation
> -
>
> Key: AMQ-7514
> URL: https://issues.apache.org/jira/browse/AMQ-7514
> Project: ActiveMQ
>  Issue Type: Task
>Reporter: Bruce Snyder
>Priority: Major
>  Time Spent: 3h 40m
>  Remaining Estimate: 0h
>
> Given the racial charged nature of certain terms in today's world, we must 
> pull together to create a plan for changing any such terms throughout all the 
> ActiveMQ projects and in the git repos themselves.
>   
>  Example: [https://activemq.apache.org/masterslave.html]
>   
>  Here are just a few terms that should be changed: * The following terms are 
> being targeted for change:
>  * 
>  ** 'master' and 'slave' should be replaced with the terms 'live' and 'backup'
>  ** 'whitelist' and 'blacklist' should be replaced with the terms 'allowlist' 
> and 'denylist'
>  * Rename all the git 'master' branches to the term 'main'
> Proposal notes from activemq-dev mailing list
> Phase 1: 
> 1. Deprecate terms such as ‘master’ and ’slave
> 2. log.warn any configuration change notifications
> 3. Provide compatibility under the covers for deprecated terms
> 4. Provide any openwire compatibility changes b/w ActiveMQ 5 and Artemis
> 5. Notify users in an announcement and provide a conversion HOWTO
> Phase 2: 
> 1. Remove terminology as part of a major or minor release (SEMVER where ‘y’ 
> in ‘x.y.z’ is minor version number)
> New terms:
> a. For shared storage: ‘active’ and ’standby’
> b. For replication: ‘primary’ and ‘replica'
> c. For 'white list' and 'blacklist': 'allow list' and 'deny list'
> For example:
> ‘master’ -> ‘active’
> ’slave’ -> ’standby'



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Commented] (AMQ-7514) Replace racially charged terms throughout source code, comments and documentation

2021-07-08 Thread Jira


[ 
https://issues.apache.org/jira/browse/AMQ-7514?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17377569#comment-17377569
 ] 

Étienne Hossack commented on AMQ-7514:
--

In general I would suggest we approach this in terms of non-inclusive language. 
There's lots of terminology one could describe as "racially charged" but also 
in general problematic terms that are not related to race or ethnicity.

Also missing from this plan is how we might go through the codebase and ensure 
everything is named inclusively in code, and likely a subtask to update the 
website.

> Replace racially charged terms throughout source code, comments and 
> documentation
> -
>
> Key: AMQ-7514
> URL: https://issues.apache.org/jira/browse/AMQ-7514
> Project: ActiveMQ
>  Issue Type: Task
>Reporter: Bruce Snyder
>Priority: Major
>  Time Spent: 10m
>  Remaining Estimate: 0h
>
> Given the racial charged nature of certain terms in today's world, we must 
> pull together to create a plan for changing any such terms throughout all the 
> ActiveMQ projects and in the git repos themselves.
>   
>  Example: [https://activemq.apache.org/masterslave.html]
>   
>  Here are just a few terms that should be changed: * The following terms are 
> being targeted for change:
>  * 
>  ** 'master' and 'slave' should be replaced with the terms 'live' and 'backup'
>  ** 'whitelist' and 'blacklist' should be replaced with the terms 'allowlist' 
> and 'denylist'
>  * Rename all the git 'master' branches to the term 'main'
> Proposal notes from activemq-dev mailing list
> Phase 1: 
> 1. Deprecate terms such as ‘master’ and ’slave
> 2. log.warn any configuration change notifications
> 3. Provide compatibility under the covers for deprecated terms
> 4. Provide any openwire compatibility changes b/w ActiveMQ 5 and Artemis
> 5. Notify users in an announcement and provide a conversion HOWTO
> Phase 2: 
> 1. Remove terminology as part of a major or minor release (SEMVER where ‘y’ 
> in ‘x.y.z’ is minor version number)
> New terms:
> a. For shared storage: ‘active’ and ’standby’
> b. For replication: ‘primary’ and ‘replica'
> c. For 'white list' and 'blacklist': 'allow list' and 'deny list'
> For example:
> ‘master’ -> ‘active’
> ’slave’ -> ’standby'



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Commented] (AMQ-7514) Replace racially charged terms throughout source code, comments and documentation

2020-10-30 Thread Scott M Messner (Jira)


[ 
https://issues.apache.org/jira/browse/AMQ-7514?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17223562#comment-17223562
 ] 

Scott M Messner commented on AMQ-7514:
--

Regardless of the the racial charge of the 'master' and 'slave' terminology – 
it's actually quite incorrect for what it implies and the actual usage. 

For example: I use [https://activemq.apache.org/jdbc-master-slave] . I think 
the fitting term is 'active' and 'passive'. I can maybe help in refactoring the 
doc, but I admit, I've very little experience in open source contributions. Do 
I just check out the doc, modify, push, and make a pull-request ? Is there a 
procedure written somewhere for getting started making contributions ?

> Replace racially charged terms throughout source code, comments and 
> documentation
> -
>
> Key: AMQ-7514
> URL: https://issues.apache.org/jira/browse/AMQ-7514
> Project: ActiveMQ
>  Issue Type: Task
>Reporter: Bruce Snyder
>Priority: Major
>
> Given the racial charged nature of certain terms in today's world, we must 
> pull together to create a plan for changing any such terms throughout all the 
> ActiveMQ projects and in the git repos themselves.
>   
>  Example: [https://activemq.apache.org/masterslave.html]
>   
>  Here are just a few terms that should be changed: * The following terms are 
> being targeted for change:
>  * 
>  ** 'master' and 'slave' should be replaced with the terms 'live' and 'backup'
>  ** 'whitelist' and 'blacklist' should be replaced with the terms 'allowlist' 
> and 'denylist'
>  * Rename all the git 'master' branches to the term 'main'
> Proposal notes from activemq-dev mailing list
> Phase 1: 
> 1. Deprecate terms such as ‘master’ and ’slave
> 2. log.warn any configuration change notifications
> 3. Provide compatibility under the covers for deprecated terms
> 4. Provide any openwire compatibility changes b/w ActiveMQ 5 and Artemis
> 5. Notify users in an announcement and provide a conversion HOWTO
> Phase 2: 
> 1. Remove terminology as part of a major or minor release (SEMVER where ‘y’ 
> in ‘x.y.z’ is minor version number)
> New terms:
> a. For shared storage: ‘active’ and ’standby’
> b. For replication: ‘primary’ and ‘replica'
> c. For 'white list' and 'blacklist': 'allow list' and 'deny list'
> For example:
> ‘master’ -> ‘active’
> ’slave’ -> ’standby'



--
This message was sent by Atlassian Jira
(v8.3.4#803005)


[jira] [Commented] (AMQ-7514) Replace racially charged terms throughout source code, comments and documentation

2020-07-13 Thread Jira


[ 
https://issues.apache.org/jira/browse/AMQ-7514?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel=17157142#comment-17157142
 ] 

Jan Šmucr commented on AMQ-7514:


Really?

Are you aware of what "Slavic" means? Since it's so popular nowadays, should I 
too be offended by my nation being classified as a nation of slaves?

Master/slave and the related have made it to be terms of their own and nothing 
is going to change it. I wonder if anyone's going to quietly remove the 
unpopular meanings from here too: 
[https://www.merriam-webster.com/dictionary/slave]

> Replace racially charged terms throughout source code, comments and 
> documentation
> -
>
> Key: AMQ-7514
> URL: https://issues.apache.org/jira/browse/AMQ-7514
> Project: ActiveMQ
>  Issue Type: Task
>Reporter: Bruce Snyder
>Priority: Major
>
> Given the racial charged nature of certain terms in today's world, we must 
> pull together to create a plan for changing any such terms throughout all the 
> ActiveMQ projects and in the git repos themselves.
>   
>  Example: [https://activemq.apache.org/masterslave.html]
>   
>  Here are just a few terms that should be changed: * The following terms are 
> being targeted for change:
>  * 
>  ** 'master' and 'slave' should be replaced with the terms 'live' and 'backup'
>  ** 'whitelist' and 'blacklist' should be replaced with the terms 'allowlist' 
> and 'denylist'
>  * Rename all the git 'master' branches to the term 'main'



--
This message was sent by Atlassian Jira
(v8.3.4#803005)