As a part of the gold standard evaluation for pywikibot, I identified several : API:Client code/Evaluations/Pywikibot#Suggested TODOs. --Fhocutt (talk) 19:07, 25 July 2014 (UTC)
Changes that would improve the documentation include:
- Add code samples to the documentation to provide easy-to-use examples for common tasks (including queries/lists/searches and edits)
- Add easy-to-find, complete, and intuitive installation instructions to the documentation. This should include installation via pip (T67176: pip install pywikibot is not straightforward) and into virtual environments (T63783: Install fails in virtualenv).
- Add documentation for people who aren't running bots with existing scripts (particularly researchers who extract data via the API and beginning/intermediate bot writers).
- Method docstrings should include a link to the corresponding mw:API subpage.