From 28d211f6f52fe26332536761d669dae4eb704fdc Mon Sep 17 00:00:00 2001 From: Estevan Pequeno Date: Tue, 3 Jul 2012 22:36:07 -0500 Subject: [PATCH] edit stub --- docs/writing/structure.rst | 19 ++++++++++--------- 1 file changed, 10 insertions(+), 9 deletions(-) diff --git a/docs/writing/structure.rst b/docs/writing/structure.rst index b1cc5de..ee328ee 100644 --- a/docs/writing/structure.rst +++ b/docs/writing/structure.rst @@ -1,21 +1,22 @@ 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. -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 -project. +project. We then discuss various perspectives on how to build code which +can be extended and tested reliably. Structure is Key -- 1.8.0.2