entities.md in power_stencil-0.4.8

- old
+ new

@@ -8,11 +8,11 @@
     - [Default entities](#default-entities)
     - [Structure overview](#structure-overview)
     - [Loose schema entities](#loose-schema-entities)
 - [Manipulating entities](#manipulating-entities)
     - [Checking entities](#checking-entities)
-    - [Querying entities](#querying-entities)
+    - [Querying and graphing entities](#querying-and-graphing-entities)
     - [Creating entities](#creating-entities)
         - [Versioned entities](#versioned-entities)
         - [Local (unversioned) entities](#local-unversioned-entities)
     - [Updating entities](#updating-entities)
     - [Deleting entities](#deleting-entities)
@@ -224,11 +224,11 @@
   - Storage path: '/tmp/tst2/.ps_project/entities/base_entity/my_2nd_entity.yaml'
   - Status      : Valid 
   - Buildable   : false
 ```
 
-## Querying entities
+## Querying and graphing entities
 
 The command to query entities from the repository is `power_stencil get`, and it works basically like the `power_stencil check` command.
 
 No parameter will return all entities, you can pass multiple ids or regexp on the command line.
 
@@ -872,11 +872,11 @@
 ```
 So you see that if we try to set parent with something wrong, the accessor seems to accept, you can even see the `#fields` Hash updated. But as soon as you try to save to entity, or if you use the `#valid?` method, it complains about the type... Cool.
 
 :information_source: The `name` property of the `has_one` directive is optional. If not present the field will be named from the entity_type referenced instead...
 
-**:information_source: See more advanced features, like the very powerful reverse methods in the [`universe_compiler` advanced relations documentation].**
+**:information_source: See more advanced features, like the very powerful reverse methods in the [`universe_compiler` advanced relations documentation].** [universe_compiler] is the Gem that manages entities under the hood, but it is much lower level than `PowerStencil`, so unless you are really interested in what happens under the hood, you should not really care about it. Yet you should definitely check what the `with_reverse_method` and `unique` options do to the `has_one` directive.
 
 #### has_many
 
 Once you know the `has_one` directive, you should not be surprised by the `has_many` directive...
 
@@ -922,10 +922,10 @@
   name: prop2
 :name: test_entity
 ```
 Nice !
 
-**:information_source: See more advanced features, like the very powerful reverse methods in the [`universe_compiler` advanced relations documentation].**
+**:information_source: See more advanced features, like the very powerful reverse methods in the [`universe_compiler` advanced relations documentation].** [universe_compiler] is the Gem that manages entities under the hood, but it is much lower level than `PowerStencil`, so unless you are really interested in what happens under the hood, you should not really care about it. Yet you should definitely check what the `with_reverse_method` and `unique` options do to the `has_many` directive.
 
 
 ### buildable and buildable_by
 
 One of the most important directives !
\ No newline at end of file