doc/builds.md in power_stencil-0.6.1 vs doc/builds.md in power_stencil-0.6.2

- old
+ new

@@ -18,10 +18,19 @@ **:warning: You should have already read the documentation about [templates], before reading this.** You build a [buildable] entity by issuing `power_stencil build <entity_type>/<entity_name>`. If you try to build an entity which is not buildable, the process fail with an error message. +**:information_source: You can get the list of buildable entities in your repository by issuing a `power_stencil build --list`:** + +``` +$ power_stencil build --list + - 'simple_exec' (buildable by 'PowerStencil core' and provided by 'PowerStencil core'). +``` + +We will see later in the [templates] part what to do with this `simple_exec` entity type. + Let's describe a bit more in detail what this build process is: ![entity-build-flow] Humm :thinking:... What is this _compilation_ step that appears on this schema ??! I thought Ruby was an interpreted language... @@ -30,10 +39,10 @@ # The "_compilation_" process The mechanism of the compilation is coming from the [universe_compiler] Gem, but the two following features are the ones you really need to understand. -:information_source: The compilation process can be applied to any entity, ie it doesn't need to be [buildable] (see in next paragraph how to run the compilation). But an entity needs to be [buildable] to use `power_stencil build` which corresponds actually to _compilation_ + _detemplatization_. +:information_source: The compilation process is actually applied to all entities, ie it doesn't need to be [buildable] (see in next paragraph how to run the compilation). But an entity needs to be [buildable] to use `power_stencil build` which corresponds actually to _compilation_ + _detemplatization_. ## Extending an entity We could describe this mechanism as inheritance at entity level (not entity type !), said differently this a way for an entity to _inherit_ (or _extend_ in the `PowerStencil` paradigm) the content of another entity. \ No newline at end of file