BP-B.2: Set up documentation

This practice spans across the entire project but is particularly important in the initial phases of the project.

The practice applies to all projects.

1. Identify relevant artifacts, processes and decisions that need to be documented
   
   1. Identify public and restricted documentation
   2. Identify the items that need and do not need to be documented
   3. For each item that needs to be documented, indicate prospective recipients for the documentation
   4. Avoid over- and under-documenting.
2. Define a policy (policies) for documenting
   1. Assign responsibility for maintaining the documentation and/or processes
   2. A documentation policy defines the content, format, recipients and maintenance approach.
   3. Define maintenance policies for various items and periodically update them. Give priority to core items or items frequently changed
   4. Periodically verify if the policy is followed and adhered to.
   5. Provide a feedback channel for the public documentation

1. The documentation policy is not followed
   
   1. The documentation becomes obsolete and its users cannot rely on it
2. The documentation policies are not properly assigned to items
   
   1. Relevant items may be inadequately documented
3. The documentation policy is not updated
   1. The policy does not correspond to current needs.

• BP-A.3: Collect requirements
• BP-B.3: Manage artifacts
• BP-B.5: Manage product issues