From: Estevan Pequeno Date: Wed, 4 Jul 2012 03:19:31 +0000 (-0500) Subject: add stub X-Git-Url: https://git.eng.unimelb.edu.au/public?p=python-guide.git;a=commitdiff_plain;h=167d566650bcb2ca5156d7af2b69f7858bda3c80 add stub --- 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 ----------------