openstack/zaqar
Code Issues Proposed changes

Merge "Added checks enforcements rule to the developers manual"

Browse Source
This commit is contained in:
Jenkins 2014-09-27 03:12:05 +00:00 committed by Gerrit Code Review
commit 8d6441541c
1 changed files with 15 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
doc/source/index.rst
View File

@ -128,12 +128,27 @@ API reference
Modules reference Modules reference
================= =================
Zaqar is composed of two layers:
.. toctree:: .. toctree::
:maxdepth: 1 :maxdepth: 1
transport transport
storage 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
------------------ ------------------