1151

1 files changed, 9 insertions, 7 deletions

diff --git a/cpp/000organization b/cpp/000organization
index 939324ef..bf017d16 100644
--- a/cpp/000organization
+++ b/cpp/000organization
@@ -11,14 +11,17 @@
 //: cycle. Doing one well makes it easier to do the other.
 //:
 //: Lower down, this file contains a legal, bare-bones C++ program. It doesn't
-//: do anything yet; subsequent files will add behaviors by inserting lines
-//: into it with directives like:
+//: do anything yet; subsequent files or 'layers' will contain directives to
+//: inserting lines into it. For example:
 //:   :(after "more events")
 //: This will insert the following lines after a line in the program containing
 //: the words "more events".
-//: A simple tool will 'tangle' these files according to the directives, though
-//: it'll drop these comments starting with a '//:' prefix that only make sense
-//: in the context of layers.
+//:
+//: A simple tool will 'tangle' all the layers together according to the
+//: directives into a single source file containing all the code for the
+//: project, and then feed the source file to the compiler. (It'll drop these
+//: comments starting with a '//:' prefix that only make sense in the context
+//: of layers.)
 //:
 //: Directives free up the programmer to order code for others to read rather
 //: than as forced by the computer or compiler. Each individual feature can be
@@ -65,8 +68,7 @@
 //:   ============
 //:
 //: Here's part of a layer in color: http://i.imgur.com/0eONnyX.png. Directives
-//: are shaded dark. Notice the references to waypoints lower down in this
-//: file.
+//: are shaded dark.
 //:
 //: Layers do more than just shuffle code around. Past the initial skeleton of
 //: this program (currently 00*-02*), it ought to be possible to stop loading