Code of Conduct/Bots: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
(→‎Edit limits: Moving the exception "clause" to its own header.)
No edit summary
 
(4 intermediate revisions by 3 users not shown)
Line 13: Line 13:


==Voting==
==Voting==
Bots themselves are not allowed to vote on any edits (to be implemented via code).
Bots themselves are not allowed to vote on any edits.


Yes-voting on bot edits is discouraged unless the voter can 100% confirm they're correct, since it helps them to go through with less eyes on them. If a bot edit gets rejected, a non-bot user can always re-enter it if he feels it's correct - reverting the edit is much more difficult, especially for removals and merges. This also applies to the bot owner: no matter how much you trust your code, manually verify everything before voting yes.
Voting yes on bot edits is discouraged unless the voter knows for sure that they are correct, since it helps them to go through with fewer eyes on them. If a bot edit gets rejected, non-bot users can always re-enter the edit if they think it is correct. Reverting the edit is much more difficult, especially for removals and merges. This also applies to the bot owner: no matter how much you trust your code, manually verify everything before voting yes.


Bot owners should read and react to edit notes on their bot edits in a reasonable amount of time. If you're not going to be able to do so, '''don't run your bot''' until that changes. Ignoring editor votes and comments on your edits is a great way for your bot to quickly lose the support of the community.
Bot owners should read and respond to edit notes on their bot edits in reasonable time. If you're not going to be able to do so, '''don't run your bot'''! Just wait until you have more time. You bot will quickly lose the support of the community if you ignore editor votes and comments on your edits.


==Bot code==
==Bot code==
We encourage that the code for every bot is open-sourced or at least made public, and that it is linked from that bot's user page. Other bot owners, and the community in general, are encouraged to check, review and (if necessary) propose patches for them. If the bot owner doesn't make the code available for checking from the beginning, and the community is unhappy with the edits the bot makes, the source code may be called into question. If the owner is unable to provide this, the bot account may be terminated.
We require that the code for every bot is [https://opensource.org/licenses open-sourced] and a link to the source must be provided from that bot's user page. Other bot owners, and the community in general, are encouraged to check, review and (if necessary) propose patches for them.

==Additional requirements==

In addition to a link to the bot's source code, the bot's user page must at minimum list who maintains the bot.

The bot should also log in to MusicBrainz every time it is run, regardless of whether it actually ends up making any edits or not, so that the MusicBrainz team can better keep track of which bots are actually active.

[[Category:WikiDocs Page]]

Latest revision as of 15:16, 26 April 2019

Bot editor type

Every bot owner must contact the MusicBrainz team when creating a bot editor, so that its user type can be set to Bot. This will let voters know that the edits are entered by a bot. Do not run any edits with your bot until the Bot type is set.

Edit limits

Open edits

There is a recommended limit of 2000 open edits and a hard limit of 2500 open edits per bot at the same time. Any bot which goes over the hard limit will be blocked.

Daily edits

Bots shouldn't make more than 1000 edits (be it normal edits or autoedits) per day - that allows users that want to check them all to do so.

Exceptions

Exceptions to the above limits can be granted in the Development Chat.

Voting

Bots themselves are not allowed to vote on any edits.

Voting yes on bot edits is discouraged unless the voter knows for sure that they are correct, since it helps them to go through with fewer eyes on them. If a bot edit gets rejected, non-bot users can always re-enter the edit if they think it is correct. Reverting the edit is much more difficult, especially for removals and merges. This also applies to the bot owner: no matter how much you trust your code, manually verify everything before voting yes.

Bot owners should read and respond to edit notes on their bot edits in reasonable time. If you're not going to be able to do so, don't run your bot! Just wait until you have more time. You bot will quickly lose the support of the community if you ignore editor votes and comments on your edits.

Bot code

We require that the code for every bot is open-sourced and a link to the source must be provided from that bot's user page. Other bot owners, and the community in general, are encouraged to check, review and (if necessary) propose patches for them.

Additional requirements

In addition to a link to the bot's source code, the bot's user page must at minimum list who maintains the bot.

The bot should also log in to MusicBrainz every time it is run, regardless of whether it actually ends up making any edits or not, so that the MusicBrainz team can better keep track of which bots are actually active.