Index: openacs-4/packages/acs-core-docs/www/xml/engineering-standards/docbook-primer.xml
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/engineering-standards/docbook-primer.xml,v
diff -u -r1.11.2.10 -r1.11.2.11
--- openacs-4/packages/acs-core-docs/www/xml/engineering-standards/docbook-primer.xml 24 Nov 2004 10:13:56 -0000 1.11.2.10
+++ openacs-4/packages/acs-core-docs/www/xml/engineering-standards/docbook-primer.xml 24 Nov 2004 12:01:57 -0000 1.11.2.11
@@ -731,16 +731,38 @@
package_name and type_extension_table
- adding optional services, including search, general comments, attachments, notifications, workflow, CR and the new CR Tcl API
+ adding optional services, including search, general
+ comments, attachments, notifications, workflow, CR and
+ the new CR Tcl API
- Document kernel coding requirements, strategy and guidelines to help code changers make decisions that meet kernel designers' criteria
+ Document kernel coding requirements, strategy and guidelines
+ to help code changers make decisions that meet kernel
+ designers' criteria
+
+ OpenACS Documentation Strategy
+
+ OpenACS documentation development is subject to the
+ constraints of the software project development and release
+ methods and cycles ().
+ Essentially, all phases of work may be active to accommodate
+ the asynchronous nature of multiple subprojects evolving by
+ the efforts of a global base of participants with culturally
+ diverse time references and scheduling idiosyncrasies.
+
+
+ The documentation strategy is to use project methods to
+ involve others by collaborating or obtaining guidance or
+ feedback (peer review) to distribute the workload and increase
+ the overall value of output for the OpenACS project.
+
+
OpenACS Documentation Strategy: Why DocBook?