Improve API doc readability (#7527)

This commit is contained in:
Paul Tötterman 2020-05-19 13:20:23 +03:00 committed by GitHub
parent 250f3eb991
commit ab3e19d814
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -33,21 +33,22 @@ with a body of:
including an ``access_token`` of a server admin. including an ``access_token`` of a server admin.
The parameter ``displayname`` is optional and defaults to the value of Parameters:
``user_id``.
The parameter ``threepids`` is optional and allows setting the third-party IDs - ``password``, optional. If provided, the user's password is updated and all
(email, msisdn) belonging to a user. devices are logged out.
- ``displayname``, optional, defaults to the value of ``user_id``.
The parameter ``avatar_url`` is optional. Must be a [MXC - ``threepids``, optional, allows setting the third-party IDs (email, msisdn)
URI](https://matrix.org/docs/spec/client_server/r0.6.0#matrix-content-mxc-uris). belonging to a user.
The parameter ``admin`` is optional and defaults to ``false``. - ``avatar_url``, optional, must be a
`MXC URI <https://matrix.org/docs/spec/client_server/r0.6.0#matrix-content-mxc-uris>`_.
The parameter ``deactivated`` is optional and defaults to ``false``. - ``admin``, optional, defaults to ``false``.
The parameter ``password`` is optional. If provided, the user's password is - ``deactivated``, optional, defaults to ``false``.
updated and all devices are logged out.
If the user already exists then optional parameters default to the current value. If the user already exists then optional parameters default to the current value.