Move the module reference to the top
Instead of having to scroll down to the bottom to read the module reference, it'd be better to make it available for developers before they get into the "how contribute section". This way, we can keep zaqar and openstack sections grouped respectively. Change-Id: I8c5e39e09352ba13b3fe2bf2d04a1dac93ac6509
This commit is contained in:
parent
4a9737117d
commit
4ef3b28f92
@ -80,6 +80,30 @@ Concepts
|
|||||||
|
|
||||||
glossary
|
glossary
|
||||||
|
|
||||||
|
Modules reference
|
||||||
|
=================
|
||||||
|
|
||||||
|
Zaqar is composed of two layers:
|
||||||
|
|
||||||
|
.. toctree::
|
||||||
|
:maxdepth: 1
|
||||||
|
|
||||||
|
transport
|
||||||
|
storage
|
||||||
|
|
||||||
|
The **transport drivers** are responsible for interacting with Zaqar clients.
|
||||||
|
Every query made by clients is processed by the transport layer,
|
||||||
|
which is in charge of passing this information to the backend and then
|
||||||
|
returning the response in a format understandable by the client.
|
||||||
|
|
||||||
|
The **storage drivers** are responsible for interacting with the storage backends
|
||||||
|
and, that way, store or retrieve the data coming from the transport layer.
|
||||||
|
|
||||||
|
In order to keep these layers decoupled, we have established that
|
||||||
|
**checks should be performed in the appropriate layer**. In other words,
|
||||||
|
transport drivers must guarantee that the incoming data is well-formed
|
||||||
|
and storage drivers must enforce their data model stays consistent.
|
||||||
|
|
||||||
Setting up a development environment
|
Setting up a development environment
|
||||||
====================================
|
====================================
|
||||||
|
|
||||||
@ -125,30 +149,6 @@ API reference
|
|||||||
|
|
||||||
api/autoindex
|
api/autoindex
|
||||||
|
|
||||||
Modules reference
|
|
||||||
=================
|
|
||||||
|
|
||||||
Zaqar is composed of two layers:
|
|
||||||
|
|
||||||
.. toctree::
|
|
||||||
:maxdepth: 1
|
|
||||||
|
|
||||||
transport
|
|
||||||
storage
|
|
||||||
|
|
||||||
The **transport drivers** are responsible for interacting with Zaqar clients.
|
|
||||||
Every query made by clients is processed by the transport layer,
|
|
||||||
which is in charge of passing this information to the backend and then
|
|
||||||
returning the response in a format understandable by the client.
|
|
||||||
|
|
||||||
The **storage drivers** are responsible for interacting with the storage backends
|
|
||||||
and, that way, store or retrieve the data coming from the transport layer.
|
|
||||||
|
|
||||||
In order to keep these layers decoupled, we have established that
|
|
||||||
**checks should be performed in the appropriate layer**. In other words,
|
|
||||||
transport drivers must guarantee that the incoming data is well-formed
|
|
||||||
and storage drivers must enforce their data model stays consistent.
|
|
||||||
|
|
||||||
Indices and tables
|
Indices and tables
|
||||||
------------------
|
------------------
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user