Difference between revisions of "TodoHelp"

From wiki.emacinc.com
Jump to: navigation, search
m (Added "Discarded" type.)
 
(14 intermediate revisions by 2 users not shown)
Line 1: Line 1:
===== Project List =====
+
=== Update Process ===
/wiki/MediaWiki:TodoTasksValidProjects - List of all current projects and where you add new projects
 
  
 +
The update process for wiki pages needs to follow this sequence:
  
===== Format =====
+
==== Datestamp for the Update ====
  
<nowiki>{{todo| comment |who1, who2, etc|project= project 1, project 2, etc}}</nowiki>
+
Add the current date and time to your TODO tag in this format:
 +
 
 +
(MM.DD.YY-HH:mm->IN±)
 +
 
 +
''Where:''
 +
 
 +
* MM is the month, [01,12]
 +
* DD is the day, [01,31]
 +
* YY is the last two digits of the year.
 +
* HH is the hour, in 24 hour time format
 +
* mm is the minute.  ''(It is okay to round to the nearest 5 minutes)''.
 +
* IN represents the initials of the engineer, as assigned elsewhere on this wiki.
 +
* ± is either a + or a - and indicates whether it passed this step and moved forward (with a +), or if it was marked Buggy, Deprecated or Obsolete (with a -).
 +
 
 +
For example:
 +
 
 +
<code>
 +
(10.22.13-23:00->MD+)
 +
</code>
 +
 
 +
Indicates that a page was changed on ''October 22, 2013 at 11pm by Mike Dean'', and that the change was to move its progress forward.
 +
 
 +
==== Order of Progression for Tags ====
 +
 
 +
# '''NotStarted''' - This tag denotes a new page that needs to be written.
 +
# '''InProgress''' - Use this whenever work is being done on a page.  This includes during revisions after a review.
 +
# '''Review''' - This tag marks that the page is ready to be reviewed (not that it has been reviewed).  Put in the initials of another engineer to review the page; if you're not sure who to put, use '''MD'''.
 +
# '''Buggy''' - This tag means that the reviewer has found bugs (not typos) in the page, and that it needs to be reworked by the person who wrote/ported it.  From here, the tag goes back to '''InProgress'''.  If no bugs were found, this stage is skipped and the next tag is used instead.
 +
# '''FinalDraft''' - This tag indicates that the page has passed the review process, and seems to be complete.  It will need to be looked at by a fresh set of eyes after a suitable period to move on to the next stage.
 +
# '''Complete''' - This tag indicates that the '''FinalDraft''' passed the "fresh set of eyes inspection," and is ready for publication.
 +
 
 +
==== Additional Tags - Usable on pages marked as Complete ====
 +
 
 +
# '''Deprecated''' - Indicates that the page will not be needed for an upcoming (but not necessarily the very next) release.
 +
# '''Obsolete''' - Indicates that the page is not valid for the current release.  This must come after '''Deprecated'''.
 +
# '''Revise''' - Use this to mark a page that has already been deployed as needing revision.  A person should be assigned to do the revision, who will then mark it for Review when the revision is complete.  It will the follow the above progression, the same as pages follow when first written.
 +
 
 +
==== For Discarding Pages ====
 +
 
 +
If you have a page you started, but never published, and it turns out to not be needed after all: mark it as '''Discarded'''.
 +
 
 +
=== Page List ===
 +
 
 +
====Frequently Used====
 +
 
 +
* [[Special:TaskList|My Task List]]
 +
 
 +
* [[Special:TaskListByProject|Generate List of TODOs by Project Tag]]
 +
 
 +
====For Reference====
 +
* [[Project Types for TODO Tasks]]
 +
<br />
 +
 
 +
====For Adding/Checking Project Tags====
 +
 
 +
* [[MediaWiki:TodoTasksValidProjects|Raw List of Valid Project Types]]
 +
 
 +
<br /><br /><br /><br /><br />
 +
====Quick Reference====
 +
 
 +
===== TODO Tagging Format =====
 +
 
 +
<nowiki>{{todo| comment |who1, who2, etc}}</nowiki> without a project<br />
 +
<nowiki>{{todo| comment |who1, who2, etc|project= project 1, project 2, etc}}</nowiki><br />
 +
<br />
 +
 
 +
==== Background Pages ====
 +
this is just a list of pages needed for this extension to work. Make sure not to edit or delete them<br />
 +
http://wikidev.emacinc.com/wiki/Template:Todo<br />
 +
http://wikidev.emacinc.com/wiki/Template:Todo.dpl<br />

Latest revision as of 13:43, 10 November 2015

Update Process

The update process for wiki pages needs to follow this sequence:

Datestamp for the Update

Add the current date and time to your TODO tag in this format:

(MM.DD.YY-HH:mm->IN±)

Where:

  • MM is the month, [01,12]
  • DD is the day, [01,31]
  • YY is the last two digits of the year.
  • HH is the hour, in 24 hour time format
  • mm is the minute. (It is okay to round to the nearest 5 minutes).
  • IN represents the initials of the engineer, as assigned elsewhere on this wiki.
  • ± is either a + or a - and indicates whether it passed this step and moved forward (with a +), or if it was marked Buggy, Deprecated or Obsolete (with a -).

For example:

(10.22.13-23:00->MD+)

Indicates that a page was changed on October 22, 2013 at 11pm by Mike Dean, and that the change was to move its progress forward.

Order of Progression for Tags

  1. NotStarted - This tag denotes a new page that needs to be written.
  2. InProgress - Use this whenever work is being done on a page. This includes during revisions after a review.
  3. Review - This tag marks that the page is ready to be reviewed (not that it has been reviewed). Put in the initials of another engineer to review the page; if you're not sure who to put, use MD.
  4. Buggy - This tag means that the reviewer has found bugs (not typos) in the page, and that it needs to be reworked by the person who wrote/ported it. From here, the tag goes back to InProgress. If no bugs were found, this stage is skipped and the next tag is used instead.
  5. FinalDraft - This tag indicates that the page has passed the review process, and seems to be complete. It will need to be looked at by a fresh set of eyes after a suitable period to move on to the next stage.
  6. Complete - This tag indicates that the FinalDraft passed the "fresh set of eyes inspection," and is ready for publication.

Additional Tags - Usable on pages marked as Complete

  1. Deprecated - Indicates that the page will not be needed for an upcoming (but not necessarily the very next) release.
  2. Obsolete - Indicates that the page is not valid for the current release. This must come after Deprecated.
  3. Revise - Use this to mark a page that has already been deployed as needing revision. A person should be assigned to do the revision, who will then mark it for Review when the revision is complete. It will the follow the above progression, the same as pages follow when first written.

For Discarding Pages

If you have a page you started, but never published, and it turns out to not be needed after all: mark it as Discarded.

Page List

Frequently Used

For Reference


For Adding/Checking Project Tags






Quick Reference

TODO Tagging Format

{{todo| comment |who1, who2, etc}} without a project
{{todo| comment |who1, who2, etc|project= project 1, project 2, etc}}

Background Pages

this is just a list of pages needed for this extension to work. Make sure not to edit or delete them
http://wikidev.emacinc.com/wiki/Template:Todo
http://wikidev.emacinc.com/wiki/Template:Todo.dpl