edit stub

diff --git a/docs/writing/structure.rst b/docs/writing/structure.rst
index b1cc5de..ee328ee 100644 (file)
--- a/docs/writing/structure.rst
+++ b/docs/writing/structure.rst
@@ -1,21 +1,22 @@
 Structuring Your Project
 ========================
 
 Structuring Your Project
 ========================
 

-When we say structure we mean the decisions you make concerning
+By "structure" we mean the decisions you make concerning

 how your project best meets its objective. We need to consider how to 
 best leverage Python's features to create clean, effective code.
 how your project best meets its objective. We need to consider how to 
 best leverage Python's features to create clean, effective code.

-In practical terms structure means the actual files and folders that 
-comprise your project as well as the way dependencies are handled within 
-the code itself.
+In practical terms, "structure" means making clean code whose logic and
+dependencies are clear as well as how the files and folders are organized
+in the filesystem. 

 
 

-How does data flow through the project? What features and functions
-can be grouped together and isolated? By answering questions like these
-you can begin to plan, in a broad sense, what your finished product will
-look like.
+Which functions should go into which modules? How does data flow through
+the project? What features and functions can be grouped together and 
+isolated? By answering questions like these you can begin to plan, in
+a broad sense, what your finished product will look like.

 
 In this section we take a closer look at Python's module and import 
 systems as they are the central element to enforcing structure in your 
 
 In this section we take a closer look at Python's module and import 
 systems as they are the central element to enforcing structure in your 

-project.
+project. We then discuss various perspectives on how to build code which
+can be extended and tested reliably.

 
 
 Structure is Key
 
 
 Structure is Key