Merge branch 'docs-restructuring' of github.com:matrix-org/synapse into develop

docs/README.rst

docs/client-server/howto.rst

docs/client-server/swagger_matrix/api-docs

docs/client-server/swagger_matrix/api-docs-directory

docs/client-server/swagger_matrix/api-docs-events

docs/client-server/swagger_matrix/api-docs-login

docs/client-server/swagger_matrix/api-docs-presence

docs/client-server/swagger_matrix/api-docs-profile

docs/client-server/swagger_matrix/api-docs-registration

docs/client-server/swagger_matrix/api-docs-rooms

docs/definitions.rst

docs/human-id-rules.rst

docs/implementation-notes/documentation_style.rst

docs/specification-NOTHAVE.rst

docs/specification.rst

docs/state_resolution.rst