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 (could change completely or disappear entirely) or a production-ready API (expected to be stable and supported for the foreseeable future). Make sure the use case is fully described here but also provide links to phab tickets with designs, technical information, and research of existing APIs.
=== 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.