Index: openacs-4/packages/acs-core-docs/www/requirements-template.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/requirements-template.html,v diff -u -N -r1.49.2.12 -r1.49.2.13 --- openacs-4/packages/acs-core-docs/www/requirements-template.html 19 Nov 2016 09:21:55 -0000 1.49.2.12 +++ openacs-4/packages/acs-core-docs/www/requirements-template.html 6 Jan 2017 09:18:42 -0000 1.49.2.13 @@ -17,15 +17,15 @@ 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 + and why it's useful. Whenever applicable, you should explicitly state what the business value of the system is.

System/Application Overview

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 + here, e.g. if it's an application-level package for OpenACS 4, briefly describe how it uses kernel services, like permissions or subsites.

Use-cases and User-scenarios

Determine the types or classes of users who would use the @@ -34,18 +34,18 @@ take, and how the system would support them.

Optional: Competitive Analysis

Describe other systems or services that are comparable to what - you're building. If applicable, say why your implementation will be + 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.

Related Links

Include all pertinent links to supporting and related material, - such as:

Requirements

+ such as:

Requirements

The main course of the document, requirements. Break up the requirements sections (A, B, C, etc.) as needed. Within each section, create a list denominated with unique identifiers that reflect any functional hierarchy present, e.g. 20.5.13. - for the first number, leave generous gaps on the first writing of requirements (e.g. 1, 10, - 20, 30, 40, etc.) because you'll want to leave room for any missing + 20, 30, 40, etc.) because you'll want to leave room for any missing key requirements that may arise.