[Checkins] SVN: bluebream/website/docs/v1.0/tutorial1.rst why sub-package

[Baiju M]

Log message for revision 115708:
  why sub-package
  

Changed:
  U   bluebream/website/docs/v1.0/tutorial1.rst

-=-
Modified: bluebream/website/docs/v1.0/tutorial1.rst
===================================================================
--- bluebream/website/docs/v1.0/tutorial1.rst	2010-08-16 17:50:30 UTC (rev 115707)
+++ bluebream/website/docs/v1.0/tutorial1.rst	2010-08-16 18:05:11 UTC (rev 115708)
@@ -849,8 +849,11 @@
 from ``zope.site.interfaces.IFolder`` interface.  The ``IFolder`` inherits
 from ``IContainer``.
 
-Let's create a new Python package named ``collector`` inside
-``src/tc``::
+To organize project source code in a better way, it is reccomended to use
+namespace packages.  You have already created a namespace package named
+``tc``.  The ticket collector code can be distributed under different
+packages inside ``tc`` namespace.  Let's create a new Python package named
+``collector`` inside ``src/tc`` to write the collector related components::
 
   $ mkdir src/tc/collector
   $ echo "# Python Package" > src/tc/collector/__init__.py
@@ -923,10 +926,10 @@
      xmlns="http://namespaces.zope.org/zope"
      xmlns:browser="http://namespaces.zope.org/browser">
 
-  <interface
-     interface="tc.collector.interfaces.ICollector"
-     type="zope.app.content.interfaces.IContentType"
-     />
+    <interface
+       interface="tc.collector.interfaces.ICollector"
+       type="zope.app.content.interfaces.IContentType"
+       />
 
   </configure>