summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAngelos Evripiotis <jevripiotis@bloomberg.net>2019-02-19 15:54:06 +0000
committerAngelos Evripiotis <angelos.evripiotis@gmail.com>2019-02-19 17:19:39 +0000
commit1fed147645ebaf40c9cfc29bd33f7ac3c4c9f9bb (patch)
tree8ab039a70cb064313ed4ce69e42ee8df5d9258ca
parent726094dab637808815f01e82cd2b49f84033dc7d (diff)
downloadbuildstream-aevri/doc_arch_tweaks.tar.gz
doc/./arch_data_model:edit comp stages for clarityaevri/doc_arch_tweaks
-rw-r--r--doc/source/arch_data_model.rst7
1 files changed, 4 insertions, 3 deletions
diff --git a/doc/source/arch_data_model.rst b/doc/source/arch_data_model.rst
index a903687af..6e78d3a67 100644
--- a/doc/source/arch_data_model.rst
+++ b/doc/source/arch_data_model.rst
@@ -72,9 +72,10 @@ deal of configurations understood by the *Element* is also understood by the cor
has default configurations built into BuildStream and configurable with the project
configuration. These include values such as *variables*, *environment*, *sandbox*, etc.
-As shown above, composition is performed in two stages, as we only need to composite
-the data from the toplevel element declaration against the composition of previous
-stages every time we instantiate an element.
+As shown above, composition is performed in two stages for each element. First
+we compose everything below the line, this happens just once per 'kind' of
+element - the result is re-used. Secondly, we compose the element declaration
+on top.
Source