Purpose

Effective documentation reviews help catch errors not only in documentation, but in the projects themselves. Better projects and supporting material reduce issues/bugs make end-users happier.

To that aim, the committer documentation review checklist should be completed by all ONAP Project SMEs and Documentation Project committers to ensure accuracy, clarity, and consistency within each document.

How to Use this Template

Here are some tips for using this template and completing a documentation review.

NOTE: This checklist relies on having a clear style guide that all developers/writers must follow to maintain consistency and a common look and feel across all ONAP projects.

Customize the Checklist

Not all sample line items in the checklist will apply to each specific document or review need. You can customize the checklist items to your document so you can capture specific feedback and improve the overall communication.

...

You can easily add, modify, copy, and remove text as it applies/relates to each document. For example, you may want to add rows to the Procedure/Body Text section to capture reviews of all subsections of a lengthy procedure. 

Prepare the Reviewers

Create a clear message on what you want reviewers to review (then you can avoid the dawdling on unfinished or unformatted sections.)

...