[doc] misc, put every reference to something in the code between backquotes 3.26
authorLaurent Peuch <cortex@worlddomination.be>
Thu, 21 Feb 2019 18:56:42 +0100
branch3.26
changeset 12464 d26382fc15d8
parent 12463 18b6d2493578
child 12465 d6fc05be2b4c
[doc] misc, put every reference to something in the code between backquotes
doc/tutorials/advanced/part02_security.rst
--- a/doc/tutorials/advanced/part02_security.rst	Thu Feb 21 18:54:46 2019 +0100
+++ b/doc/tutorials/advanced/part02_security.rst	Thu Feb 21 18:56:42 2019 +0100
@@ -52,10 +52,10 @@
 To implement the read security defined earlier, groups are not enough, we'll
 need some RQL expression. Here is the idea:
 
-* add a `visibility` attribute on Folder, File and Comment, which may be one of
+* add a `visibility` attribute on `Folder`, `File` and `Comment`, which may be one of
   the value explained above
+* add a `may_be_read_by` relation from `Folder`, `File` and `Comment` to `users`,
 
-* add a `may_be_read_by` relation from Folder, File and Comment to users,
   which will define who can see the entity
 
 * security propagation will be done in hook.
@@ -87,7 +87,7 @@
 
 We can note the following points:
 
-* we've added a new `visibility` attribute to folder, file, image and comment
+* we've added a new `visibility` attribute to `Folder`, `File`, `Image` and `Comment`
   using a `RelationDefinition`
 
 * `cardinality = '11'` means this attribute is required. This is usually hidden
@@ -186,7 +186,7 @@
 
 * on entity creation, schedule an operation that will set default visibility
 
-* when a "parent" relation is added, propagate parent's visibility unless the
+* when a `parent` relation is added, propagate parent's visibility unless the
   child already has a visibility set
 
 Here is the code in cube's :file:`hooks.py`:
@@ -230,7 +230,7 @@
   hook specific `match_rtype` selector.
 
 * usage of `DataOperationMixIn`: instead of adding an operation for each added entity,
-  DataOperationMixIn allows to create a single one and to store entity's eids to be
+  `DataOperationMixIn` allows to create a single one and to store entity's eids to be
   processed in the transaction data. This is a good pratice to avoid heavy
   operations manipulation cost when creating a lot of entities in the same
   transaction.
@@ -251,7 +251,7 @@
     `self.rtype`)
 
 The `parent` visibility value is used to tell "propagate using parent security"
-because we want that attribute to be required, so we can't use None value else
+because we want that attribute to be required, so we can't use `None` value else
 we'll get an error before we get any chance to propagate...
 
 Now, we also want to propagate the `may_be_read_by` relation. Fortunately,