update docs

vocabulary.org

@@ -18,27 +18,36 @@ body {
 
 ** Weave
 Defines a collection of ornaments.
-Can assign one weave as default.
 ** Ornament
 Has reactive inputs and outputs.
 Serves as an externally invocable entry point.
 Contains spells or nested ornaments.
+Can be distributed within a grimoire or a servitor.
 ** Spell
 Has reactive inputs and outputs.
 Atomic execution unit.
 Cannot be directly invoked externally.
 May have an inscription.
-Created from a scroll and executed in its runtime environment.
+Created from a scroll and executed in the shelf environment.
 ** Stitch
 Connects a reactive input to a compatible reactive output.
 ** Inscription
-Defines code in a scripting language to be ran when the corresponding spell is executed.
+Defines code in a scripting language to be run when the corresponding spell is executed.
+May be defined statically in the weave or considered a reactive input.
 ** Scroll
 Defines source code, its build dependencies and runtime environment.
 Provides a default spell configuration.
+Declares runtime compatibility (browser-only, non-browser, or universal).
 ** Shelf
 Contains all the scrolls defined in a project as well as its dependencies.
+Provisions a shared runtime environment for spells based on these scrolls.
 ** Edition
-Represents a weave as a compiled program.
+Represents (a part of) the weave as a grimoire, a servitor, or a consistent collection of these.
+** Grimoire
+Presents a set of ornaments as a program with human-facing interface.
+Uses bridge spells to communicate with servitor-side ornaments within the same edition.
+Has a dedicated interface ornament (entry point).
+** Servitor
+Presents a set of ornaments as a local/remote daemon/server endpoints/methods.
 ** Loom
 Provisions tools for interactive or programmatic weaving.