Re: [JIRA] (MDEV-36629) Change SLAVE to REPLICA in Server error messages
Taking this discussion out of the MDEV-36629 specifics, as this is a general issue. It concerns a problem with how documentation is now being incorrectly updated: "Alex Hanshaw (Jira)" <jira@mariadb.org> writes:
Alex Hanshaw commented on MDEV-36629:
Understood. For context Vikas had told the Doc team "I understand the compatibility issue - so we need to make both options work and document only the new terminology." When the Doc team asked about the
Ouch. This will need to be reverted ASAP, before more damage is done. The documentation is for documenting how the server works. All aspects of how it works. Not some distorted version, whether good- or ill-intended. We must certainly _not_ deliberately remove documentation of existing syntax and functionality! For example I see that documentation of the syntax START SLAVE was removed. This is just plain wrong. START SLAVE is working syntax in replication, and will remain so for the foreseeable future. It needs to be documented for users to be able to understand how it works. Please take this seriously, and ensure that such changes are stopped immediately, and all incorrect changes reverted. - Kristian.
Change SLAVE to REPLICA in Server error messages ------------------------------------------------
Key: MDEV-36629 URL: https://jira.mariadb.org/browse/MDEV-36629 Project: MariaDB Server Issue Type: Task Components: Replication Reporter: Shwetha CM Assignee: Sergei Golubchik Priority: Major Fix For: N/A
Hi, Kristian, I totally agree and I've now documented all "SLAVE" commands (as they still work, so must be in the documentation) taking the cue from how mysqldump and mysqladmin (that also still work) are documented. Regards, Sergei Chief Architect, MariaDB Server and security@mariadb.org On Apr 18, Kristian Nielsen via developers wrote:
Taking this discussion out of the MDEV-36629 specifics, as this is a general issue. It concerns a problem with how documentation is now being incorrectly updated:
"Alex Hanshaw (Jira)" <jira@mariadb.org> writes:
Alex Hanshaw commented on MDEV-36629:
Understood. For context Vikas had told the Doc team "I understand the compatibility issue - so we need to make both options work and document only the new terminology." When the Doc team asked about the
Ouch.
This will need to be reverted ASAP, before more damage is done.
The documentation is for documenting how the server works. All aspects of how it works. Not some distorted version, whether good- or ill-intended.
We must certainly _not_ deliberately remove documentation of existing syntax and functionality!
For example I see that documentation of the syntax START SLAVE was removed. This is just plain wrong. START SLAVE is working syntax in replication, and will remain so for the foreseeable future. It needs to be documented for users to be able to understand how it works.
Please take this seriously, and ensure that such changes are stopped immediately, and all incorrect changes reverted.
- Kristian.
participants (2)
-
Kristian Nielsen -
Sergei Golubchik