On https://github.com/wikimedia/pywikibot-core/pull/18, a user is pointed to "Developing pywikibot" at https://www.mediawiki.org/wiki/Manual:Pywikibot, but where should you go from there?
- The first link (https://www.mediawiki.org/wiki/Project:Pywikibot) is not really useful as an introduction.
- The second is the main docs, but there doesn't seem to be info about how to contribute there either (https://doc.wikimedia.org/pywikibot/search.html?q=contributing&check_keywords=yes&area=default)
- The third are links to Gerrit (with its not-intuitive user interface) and Github
- ... and so on
What would be useful to have is a page with a few straightforward points on how to contribute. Something like this:
- Sign up for developer access at https://www.mediawiki.org/wiki/Developer_access
- Read the Gerrit tutorial at https://www.mediawiki.org/wiki/Gerrit/Tutorial to learn how to set up git-review and submit patches (pull requests)
- Download code: git clone ssh://USERNAME@gerrit.wikimedia.org:29418/pywikibot/core.git pywikibot-core (replace USERNAME with your username)
- Configure git-review: git review -s
- Checkout a branch to work on: git checkout -b BRANCHNAME origin/master
- Make your changes. Remember to add tests. For info about how to run tests, see tests/README.rst
- Commit your changes (see the linked tutorial above for more details). When writing a commit message, please
- prefix it with [FIX], [FEAT], [IMPR], ... (Please help me fill out this, I couldn't find an authoritative list of prefixes to use)
- Use the last line to add a reference to the Phabricator task if one exists, e.g. Bug: T166459.
- Push your changes to Gerrit: git review -R
Alternatively, you can use the Gerrit Patch Uploader (https://tools.wmflabs.org/gerrit-patch-uploader/)