| Danmichaelo created this task. Danmichaelo added projects: Pywikibot-core, Pywikibot-Documentation. Herald added subscribers: pywikibot-bugs-list, Aklapper. Herald added a project: Documentation. |
TASK DESCRIPTION
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://[email protected]: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 and commit them (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
TASK DETAIL
EMAIL PREFERENCES
To: Danmichaelo
Cc: Aklapper, pywikibot-bugs-list, Danmichaelo, Ivana_Isadora, Magul, Tbscho, MayS, Mdupont, JJMC89, Avicennasis, jayvdb, Dalba, Masti, Alchimista, Rxy, Jay8g
Cc: Aklapper, pywikibot-bugs-list, Danmichaelo, Ivana_Isadora, Magul, Tbscho, MayS, Mdupont, JJMC89, Avicennasis, jayvdb, Dalba, Masti, Alchimista, Rxy, Jay8g
_______________________________________________ pywikibot-bugs mailing list [email protected] https://lists.wikimedia.org/mailman/listinfo/pywikibot-bugs
