Index: openacs-4/packages/acs-core-docs/www/requirements-template.adp =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/requirements-template.adp,v diff -u -r1.1.2.4 -r1.1.2.5 --- openacs-4/packages/acs-core-docs/www/requirements-template.adp 9 Jun 2016 08:44:50 -0000 1.1.2.4 +++ openacs-4/packages/acs-core-docs/www/requirements-template.adp 23 Jun 2016 08:32:46 -0000 1.1.2.5 @@ -30,19 +30,19 @@ Vision Statement
Very broadly, describe how the system meets a need of a business, group, the OpenACS as a whole, etc. Make sure that technical and non-technical readers alike would -understand what the system would do and why it's useful. Whenever -applicable, you should explicitly state what the business value of -the system is.
+understand what the system would do and why it's useful. +Whenever applicable, you should explicitly state what the business +value of the system is.Discuss the high-level breakdown of the components that make up the system. You can go by functional areas, by the main transactions the system allows, etc.
You should also state the context and -dependencies of the system here, e.g. if it's an application-level -package for OpenACS 4, briefly describe how it uses kernel -services, like permissions or subsites.
+dependencies of the system here, e.g. if it's an +application-level package for OpenACS 4, briefly describe how it +uses kernel services, like permissions or subsites.Describe other systems or services -that are comparable to what you're building. If applicable, say why -your implementation will be superior, where it will match the +that are comparable to what you're building. If applicable, say +why your implementation will be superior, where it will match the competition, and where/why it will lack existing best-of-breed capabilities. This section is also in the Design doc, so write about it where you deem most appropriate.
Include all pertinent links to supporting and related material, such as:
System/Package "coversheet" - where all documentation for this -software is linked off of
Design document
Developer's guide
User's guide
Other-cool-system-related-to-this-one document
Test plan
Competitive system(s)
System/Package "coversheet" - where all documentation +for this software is linked off of
Design document
Developer's guide
User's guide
Other-cool-system-related-to-this-one document
Test plan
Competitive system(s)
10.0 A Common Solution
Programmers and designers should only have to learn a single system that serves as a UI substrate for all the functionally @@ -127,8 +127,8 @@