Project Types for TODO Tasks

From wiki.emacinc.com
Jump to: navigation, search

Project Types

This page lists the different project types which need to be used to mark wiki pages. The project types go into a comma separated list after a project= in the TODO list tag.

Tag Format:

{{todo|Message|user_name|project=project1, project2, project3}}
todo
This is the name of the plugin. Should always be todo
Message
This is the note about the text. This is a plain-text, human readable comment.
user_name
This is the name of the user to which the page is assigned. For instance, mdean
project1, project2
These are the names of the projects to which the page belongs, as detailed below. The project= tag needs to always precede this list. If the project name has a space in it, just enter it into this list with the space intact. No quotes/etc. are needed.


Project Tags

These are the tags to use. The comments describe them.



Release Versions

The following list release versions for which a page is valid and for which it needs to be complete.

  • oe 4
  • oe 5 This is OE 5.x
  • oe 5.0
  • oe 5.1


Engineer List

The following list contains the initials to use for assigning tasks to specific engineers/interns:

  • AW - Andrew Wichmann
  • BS - Brian Serrano
  • KY - Klint Youngmeyer
  • MD - Michael Dean
  • MG - Michael Gloff
  • MW - Michael Welling
  • TS - Travis Stratman
  • JJ - Jeff Jung


Status Indicator Types

The following types are used to indicate the current status of a page. Only one of these tags should appear in the TODO tag of a page at any one time.

  • NotStarted - Use this to indicate that the pages needs to be written from scratch.
  • InProgress - Use this to indicate that the page is currently being worked on.
  • Review - Use this to indicate that the page needs to be reviewed.
  • FinalDraft - Use this to indicate that the page has been reviewed, and pending further comments, is ready to be marked complete.
  • Complete - Use this to indicate that the page has passed any scrutiny given after being marked FinalDraft. This should be done by the 2nd reviewer.
  • Deprecated - Use this to indicate that the information on the page is going to be invalidated by an upcoming release.
  • Obsolete - Use this to indicate that the information on the page is no longer valid for the current release; page is kept for reference for customers still using/maintaining an older image for which this page does apply.
  • Buggy - Use this to indicate that there are bugs in the content of the page.
  • Revise - Use this to indicate that the page needs to be revised, such as for an upcoming release.
  • Discarded - Use this for a page that was started, then later determined to not be needed after and, as a result, was never published.


NOTE: The difference between Buggy and Revise is that Buggy indicates that there are problems with the page which need to be addressed before its status will be upgraded to FinalDraft or to Complete, while Revise indicates that the page is marked to be revised later on (before the next round of releases) but the article is fine for the version of our software that it documented.