[Checkins] SVN: zopetoolkit/doc/source/about/coreextra.rst Detail the considerations more at the risk of making it harder to

[Martijn Faassen]

Log message for revision 104337:
  Detail the considerations more at the risk of making it harder to
  understand.
  

Changed:
  U   zopetoolkit/doc/source/about/coreextra.rst

-=-
Modified: zopetoolkit/doc/source/about/coreextra.rst
===================================================================
--- zopetoolkit/doc/source/about/coreextra.rst	2009-09-18 14:54:42 UTC (rev 104336)
+++ zopetoolkit/doc/source/about/coreextra.rst	2009-09-18 14:58:52 UTC (rev 104337)
@@ -56,17 +56,26 @@
 Libraries may have a different status in the core to convey extra
 information about them, such as deprecation status.
 
-Reasons to consider removing a library from the core are (or at least
-factoring out code):
+Reasons to consider refactoring packages, making dependencies optional
+or removing a library from the ZTK are::
 
+* if a library contains specific user interface code this makes it a
+  candidate for splitting it into a reusable non-UI part and a UI part
+  that is outside of the toolkit. If a library is UI focused it makes it
+  a candidate for removal from the toolkit.
+
 * if a library doesn't have narrative documentation and there is no
-  commitment from maintainers to create such documentation.
+  commitment from maintainers to create such documentation. Naturally
+  critical libraries with a lot of use won't just removed for this reason,
+  but this should also be a good motivator to add documentation.
 
-* if a library depends on a zope.* package that is itself not in the
-  core.
+* if a library depends on another library maintained in the Zope
+  repository that is itself not in the core we should think about
+  removing this dependency or making the dependency optional. Another
+  possibility is to remove the library that has this dependency from
+  the toolkit altogether, or to adopt the dependency itself into the
+  toolkit.
 
-* if a library contains specific user interface code.
-
 Extra libraries
 ---------------