From 167d566650bcb2ca5156d7af2b69f7858bda3c80 Mon Sep 17 00:00:00 2001 From: Estevan Pequeno Date: Tue, 3 Jul 2012 22:19:31 -0500 Subject: [PATCH] add stub --- docs/writing/structure.rst | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) diff --git a/docs/writing/structure.rst b/docs/writing/structure.rst index 0d2989b..b1cc5de 100644 --- a/docs/writing/structure.rst +++ b/docs/writing/structure.rst @@ -1,9 +1,22 @@ Structuring Your Project ======================== -Structuring your project properly is extremely important. +When we say 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. + +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. -.. todo:: Fill in "Structuring Your Project" stub Structure is Key ----------------