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.