archive
/
matrix-spec-proposals
mirror of https://github.com/matrix-org/matrix-spec-proposals
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

documentation_style: fix indentation

Browse Source
pull/1120/head
Richard van der Hoff 7 years ago committed by GitHub
parent 306783b7bf
commit 3c40d5a94e
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 11 additions and 11 deletions
Show Stats Download Patch File Download Diff File

8
meta/documentation_style.rst
Unescape Escape View File

@ -67,16 +67,16 @@ OpenAPI
When writing OpenAPI specifications for the API endpoints, follow these rules: When writing OpenAPI specifications for the API endpoints, follow these rules:
* ``summary``: a phrase summarising what this API does. Start with a capital, * ``summary``: a phrase summarising what this API does. Start with a capital,
end with a full-stop. Examples: "Sends an event."; "Searches the directory." end with a full-stop. Examples: "Sends an event."; "Searches the directory."
* ``description``: a longer description of the behaviour of this API, written * ``description``: a longer description of the behaviour of this API, written
in complete sentences. in complete sentences.
* ``operationId``: a camelCased unique identifier for this endpoint. This will * ``operationId``: a camelCased unique identifier for this endpoint. This will
be used to automatically generate bindings for the endpoint. be used to automatically generate bindings for the endpoint.
* Parameter and property ``description``\s: a phrase summarising the behaviour * Parameter and property ``description``\s: a phrase summarising the behaviour
of this parameter or property, optionally followed by sentences giving more of this parameter or property, optionally followed by sentences giving more
detailed explanations. detailed explanations.

Write Preview
Loading…
Cancel
Save