REST API documentation with rST

OpenStack uses reStructuredText to document their REST API.

Example:

• https://docs.openstack.org/api-ref/database/?expanded=id30-detail,create-datastore-version-detail
• Source: https://opendev.org/openstack/trove/src/branch/master/api-ref/source
• Source: https://opendev.org/openstack/trove/src/branch/master/api-ref/source/datastore-versions.inc

They use rST with shared parameter definitions in a parameters.yaml file, and have custom directives like .. rest_method:: and .. rest_parameters::