Description

We are introducing the notion of audiences, starting with beta. Beta is already in use by at least one API module, with many more beta modules on the horizon. However, we do not currently have explicit instructions for how and where to use a beta module as part of the overall API lifecycle, nor how they should be technically configured.

Conditions of acceptance

• Create a user guide for how and when to use the 'beta' audience designation
• Outline the purpose of a beta module (see: https://www.mediawiki.org/wiki/Wikimedia_APIs/Stability_policy#Module_audiences for basic information; consult Halley with questions)
• Outline the module configuration steps
  • Emphasize the outcomes for publishing an visibility, resulting from the audience definition
• [Optional] Outline implications of 'toggleable' feature of audiences and how this will appear within the UI
• Publish on mediawiki.org
  • Assume that we will continue updating this guide with information about additional audiences and how to use them, as we introduce them