API:Client code/Gold standard/de

Die Client-Bibliotheken der Action API, die auf verfügbar sind, ermöglichen es Entwicklern, einfach und intuitiv mit der MediaWiki-API zu interagieren. Die derzeit aufgelisteten Bibliotheken unterscheiden sich erheblich hinsichtlich Möglichkeiten, Entwicklungsstatus und Qualität von Code/Dokumentation. Um es neuen Nutzern der API zu erleichtern, eine Bibliothek zu finden, die ihre Ansprüche erfüllt, führen wir einen "Gold-Standard" ein, der insbesondere qualitativ hochwertige, derzeit gewartete Bibliotheken kennzeichnet. Wir hoffen auch, dass der Standard Entwicklern von Bibliotheken dabei hilft, zu entscheiden, worauf sie ihre Anstrengungen fokussieren, sodass der von ihnen erstellte Code einfach von Experten und neuen Entwicklern genutzt werden kann.

Wir glauben, dass eine gute Client-Bibliothek einfach zu installieren, zu verstehen, zu nutzen, zu debuggen und zu verbessern sein sollte. Dafür ist eine zusätzliche Dokumentation ebenso wichtig wie eleganter Code. Sofern nichts anderes angegeben ist, gehören die Objekte unten zum "Gold-Standard": herausfordernd aber erreichbar. Die Objekte, die als "Platin-Standard" gekennzeichnet sind, zeigen, dass Bibliotheksentwickler weiter gegangen sind und über den "Gold-Standard" hinausgehen, was zu einer außergewöhnlichen Bibliothek führt.

Einfach zu installieren

 * Installationsanleitungen sind korrekt und leicht zu finden
 * Die Bibliothek ist über eine geeignete Paket-Bibliothek (PyPI, CPAN, npm, Maven, rubygems, etc.) als Paket zur Installation verfügbar
 * Platin-Standard: Die Bibliothek ist über Linux-Distributionen als Paket verfügbar

Einfach zu verstehen

 * Well designed: makes all intended API calls available with the intended level of abstraction with no redundancies
 * Platinum standard: makes the Wikidata API available
 * Well documented:
 * Code is commented and readable
 * Documentation is comprehensive, accurate, and easy to find
 * Documentation specifies which MediaWiki versions the library is compatible with
 * Deprecated functions are clearly marked as such
 * Platinum standard: Documentation is understandable by a novice programmer
 * Code uses idioms appropriate to the language the library is written in

Easy to use

 * Has functioning, simple, and well-written code samples for common tasks
 * Demonstrates queries
 * Demonstrates edits
 * Handles API complications or idiosyncrasies so the user doesn't have to:
 * Login/logout
 * Cookies
 * Tokens
 * Query continuations using the new "continue" and not "query-continue"
 * Requests via https, including certificate validation
 * Courteous API usage is promoted through code samples and smart defaults
 * gzip compression is used by default
 * Examples show how to create and use a meaningful user-agent header (as in User-agent policy)
 * Platinum standard: generates a unique user-agent string given name/email address/repository location
 * Efficient usage of API calls
 * Can be used with the most recent stable version of the language it is written in (e.g. Python 3 compatible)

Easy to debug

 * Contains unit tests for the longest and most frequently modified functions in the library
 * Platinum standard: Unit tests for many code paths exist and are maintained
 * Terrible hacks/instances of extreme cleverness are clearly marked as such in comments
 * Documentation links to the relevant section/subpage of the API documentation

Easy to improve

 * Library maintainers are responsive and courteous, and foster a thoughtful and inclusive community of developers and users
 * Platinum standard: Project sets clear expectations for conduct for spaces where project-related interactions occur (mailing list, IRC, repository, issue tracker). It should:
 * State desired attitudes and behaviors
 * Provide examples of unwelcome and harassing behavior
 * Specify how these expectations will be enforced
 * Pull requests are either accepted or rejected with reason within 3 weeks (Platinum standard: 3 business days)
 * Issues/bugs are responded to in some manner within 3 weeks (Platinum standard: 3 business days) (but not necessarily fixed)
 * The library is updated and a new version is released within 3 weeks (Platinum standard: 3 business days) when breaking changes are made to the API
 * Platinum standard: library maintainers contact MediaWiki API maintainers with feedback on the API's design and function
 * Library specifies the license it is released under