API:Client code/Evaluations/MediaWiki-Butt

MediaWiki::Butt is a Ruby library for accessing the MediaWiki API. It provides a basic, powerful, feature-rich framework for querying and editing wiki content, as well as administration tasks like updating user rights.

Well designed--makes all intended API calls available with the intended level of abstraction with no redundancies

There are both high-level and low-level methods for users of different skill levels. Methods for most APIs are available, as well as a public post method in which the user can provide method parameters, headers, and set the return type of either JSON or raw HTTP response.

Platinum standard: makes the Wikidata API available

N Does not make any Wikibase functions available, even at the level of wrapping custom API calls. The methods provided can be used on the Wikidata API endpoint, however.

Well documented

Code is commented and readable

YARD comments are present and useful. Different files are easily identifiable for different purposes.

Documentation is comprehensive, accurate, and easy to find

RubyDoc linked in the README is hosted through GitHub Pages, and as such, has significantly less downtime than the RubyDoc server. This is the only suggested documentation location.

Deprecated functions are clearly marked as such

n/a

Platinum standard: Documentation is understandable by a novice programmer

Documentation is very entry-level and often uses terms described in the actual MediaWiki API.

Code uses idioms appropriate to the language the library is written in