Index: script.txt
==================================================================
--- script.txt
+++ script.txt
@@ -158,32 +158,31 @@
 that can be used to study the testbed itself or to implement external services
 (like node monitoring and selection).
 
 ** An example experiment
 # Event diagram, hover over components explained.
-To show how the testbed works: two slivers, one of them (source sliver) pings
-the other one (target sliver).
+To show how the testbed works: two slivers, one of them pings the other one.
+Let's call them the source and target sliver, respectively.
 
 1. The researcher first contacts the server and creates a slice description
-   which specifies a template for slivers (e.g. Debian Squeeze i386).
-   Experiment data is attached including a program to setup the experiment and
-   another one to run it.
-2. The server updates the registry which holds all definitions of testbed,
-   nodes, users, slices, slivers, etc.
+   which specifies a template for slivers (e.g. Debian Squeeze i386).  The
+   researcher attaches experiment data including a program to setup slivers
+   for the experiments and another one to run them.
+2. This and all subsequent changes initiated by the researcher are stored in
+   the registry, which holds the config of all components in the testbed.
 3. The researcher chooses a couple of nodes and creates sliver descriptions
    for them belonging to the previous slice.  Both sliver descriptions include
-   a public interface to the CN and user-defined properties for telling apart
-   the source sliver from the target one.  Sliver descriptions go to the
-   registry.
+   a public interface to the CN and user-defined properties to mark slivers as
+   either source or target.
 4. Each of the previous nodes gets a sliver description for it.  If enough
    resources are available, a container is created by applying the desired
    configuration over the selected template.
 5. Once the researcher knows that slivers have been instantiated, the server
-   can be commanded to activate the slice.  The server updates the registry.
+   can be commanded to activate the slice.
 6. When nodes get instructions to activate slivers they start the containers.
-7. Containers run the experiment setup program and the run program.  The
-   programs query sliver properties to decide their behaviour.
+7. Containers execute the experiment's setup and run programs.  The programs
+   query sliver properties to decide whether to act as source or target.
 8. Researchers interact straight with containers if needed (e.g. via SSH) and
    collect results from them.
 9. When finished, the researcher tells the server to deactivate and
    deinstantiate the slice.
 10. Nodes get the instructions and they stop and remove containers.