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?