summaryrefslogtreecommitdiff
path: root/docs/reference
diff options
context:
space:
mode:
authordrebs <drebs@riseup.net>2017-10-23 10:21:21 -0200
committerdrebs <drebs@riseup.net>2017-10-23 10:38:02 -0200
commit33e30feb2d7cedb1aecbde2f339b40f72128a585 (patch)
tree1de5fb8dd4858dd24b1b0185c7a9aa0a954684ac /docs/reference
parentb3bf0be478060a3acdf01c924819212553775f8c (diff)
[doc] small fixes in documentation
Diffstat (limited to 'docs/reference')
-rw-r--r--docs/reference/blobs.rst2
-rw-r--r--docs/reference/incoming_box.rst30
-rw-r--r--docs/reference/server-database.rst22
3 files changed, 26 insertions, 28 deletions
diff --git a/docs/reference/blobs.rst b/docs/reference/blobs.rst
index 5d480342..17880802 100644
--- a/docs/reference/blobs.rst
+++ b/docs/reference/blobs.rst
@@ -39,7 +39,7 @@ The public endpoint provides the following REST API for interacting with the
=========================== ========== ================================= ============================================
path method action accepted query string fields
=========================== ========== ================================= ============================================
-``/blobs/{uuid} ``GET`` Get a list of blobs. filtered by ``namespace``, ``filter_flag``, ``order_by``
+``/blobs/{uuid}`` ``GET`` Get a list of blobs. filtered by ``namespace``, ``filter_flag``, ``order_by``
a flag.
``/blobs/{uuid}/{blob_id}`` ``GET`` Get the contents of a blob. ``namespace``
``/blobs/{uuid}/{blob_id}`` ``PUT`` Create a blob. The content of the ``namespace``
diff --git a/docs/reference/incoming_box.rst b/docs/reference/incoming_box.rst
index 04d3084c..920d03bf 100644
--- a/docs/reference/incoming_box.rst
+++ b/docs/reference/incoming_box.rst
@@ -230,22 +230,20 @@ registered Trusted Application Consumers.
process, attention SHOULD be payed to the callbacks not blocking the main
event loop.
-Example of a Trusted Application Client Consumer:
-
-```python
-@implementer(interfaces.IIncomingBoxConsumer)
-class MyConsumer(object):
- def __init__(self):
- self.name = 'My Consumer'
-
- def process(self, item, item_id, encrypted=True):
- cleartext = my_custom_decrypt(item) if encrypted else item
- processed_parts = my_custom_processing(item)
- return defer.succeed(processed_parts)
-
- def save(self, parts, item_id):
- return defer.gatherResults([db.save(part) for part in parts])
-```
+Example of a Trusted Application Client Consumer::
+
+ @implementer(interfaces.IIncomingBoxConsumer)
+ class MyConsumer(object):
+ def __init__(self):
+ self.name = 'My Consumer'
+
+ def process(self, item, item_id, encrypted=True):
+ cleartext = my_custom_decrypt(item) if encrypted else item
+ processed_parts = my_custom_processing(item)
+ return defer.succeed(processed_parts)
+
+ def save(self, parts, item_id):
+ return defer.gatherResults([db.save(part) for part in parts])
Future Features
diff --git a/docs/reference/server-database.rst b/docs/reference/server-database.rst
index d3dfdb5f..dba9d42c 100644
--- a/docs/reference/server-database.rst
+++ b/docs/reference/server-database.rst
@@ -29,20 +29,20 @@ which recovery document belongs to each user.
This has some implications:
- * The security of the recovery document doc_id, and thus of access to the
- recovery document (encrypted) content, as well as tampering with the
- stored data, all rely on the difficulty of obtaining the user's password
- (supposing the user's uid is somewhat public) and the security of the hash
- function used to calculate the doc_id.
+* The security of the recovery document doc_id, and thus of access to the
+ recovery document (encrypted) content, as well as tampering with the
+ stored data, all rely on the difficulty of obtaining the user's password
+ (supposing the user's uid is somewhat public) and the security of the hash
+ function used to calculate the doc_id.
- * The security of the content of a recovery document relies on the
- difficulty of obtaining the user's password.
+* The security of the content of a recovery document relies on the
+ difficulty of obtaining the user's password.
- * If the user looses his/her password, he/she will not be able to obtain the
- recovery document.
+* If the user looses his/her password, he/she will not be able to obtain the
+ recovery document.
- * Because of the above, it is recommended that recovery documents expire
- (not implemented yet) to prevent excess storage.
+* Because of the above, it is recommended that recovery documents expire
+ (not implemented yet) to prevent excess storage.
The authorization for creating, updating, deleting and retrieving recovery
documents on the shared database is handled by `leap.soledad.server.auth`