Proposing a new template for incoming API requests. This would live in the sidebar of the Product Infrastructure board alongside the existing standard task, bug report, and research/spike task links. Feel free to adjust or add fields if there's anything I missed.
=== Intended use
Describe the intended use of the API. Specify whether this is an experimental API for a test run in a beta build or a production-ready API. Provide links to phab tickets with any additional information, but make sure the use case is fully described here.
=== Input
Provide each input parameter, its data type, and a brief description of valid values.
For example:
language: String - the language code of a Wikipedia project
title: String - a page title in the main namespace of the Wikipedia in the language provided
=== Output
Provide example responses for given input parameters, describe edge cases.
=== Throughput
Provide estimated throughput in requests/second for the endpoint.
=== Response time
Provide the required average acceptable 50th, 75th, and 90th percentile response time.