Introduction

We have a simple review process for Launchpad help materials. Our two aims for the review process are to:

• minimise bottlenecks
• ensure Launchpad help materials are both accurate and easy to read.

If you produce or edit Launchpad help materials, please do take a few moments to get your work reviewed.

Minor edits in the Help wiki

1. Make your changes directly in the help wiki.
2. Mail the launchpad-users list with a diff of your change. Start the email's subject with "Doc RFC:".

Substantial Help wiki edits

1. Before editing, copy the wiki page contents into an /Edit page: e.g. if you're editing the Feeds page, copy its unedited contents into Feeds/Edit.

2. Save the unedited version in the /Edit page, to enable a reviewer to easily produce a diff between your draft and the original.

3. Write "Draft copy" at the top of the page as a = header.

4. Make your edits.

5. Mail the launchpad-users list and cc matthew.revell@canonical.com with a link to your draft in /Edit. Start the email's subject with "Doc RFC:".

6. Iteratively edit the document and republish the draft, following review comments on the mailing list.
7. At least one other member of the team should declare the page ready for publication.

8. Remove the draft warning, publish to the main page and then delete /Edit page.

New pages

1. Create an /Edit page under the new page - e.g. /NewPage/Edit

2. Write "Draft copy" at the top of the page as a = header.

3. Make your edits.

4. Mail the launchpad-users list and cc matthew.revell@canonical.com with a link to your draft in /Edit. Start the email's subject with "Doc RFC:".

5. Iteratively edit the document and republish the draft, following review comments on the mailing list.
6. At least one other member of the team should declare the page ready for publication.

7. Remove the draft warning, publish to the main page and then delete /Edit page.