Fw: Notes on Wiki Cleanup

Hi, all.

Ben is asking for our help in making sure that the documents in the WIKI
are truly ready for conversion to XML. He's created a checklist (in the
message below) of items we need to check. There are three categories:

General stuff
How to Meet documents
Techniques and Failures

Michael has to pull back from WCAG a little and focus on Watchfire work so
I volunteered to get this note out to the team and see who can help.

We're in pretty good shape on these things, but this is a useful list
and it will be good for us to go through the documents again just to
make sure.

Ben will be using an automated conversion process to convert these
documents from WIKI to XML. The automation isn't smart enough to fix our
mistakes, so we need to do what we can to help it along.

Since Michael cancelled our team calls, maybe we can just do this by
e-mail. We own guidelines 2.1, 2.2, and 4.2. Can anyone sign up to take an
entire guideline and complete Ben's checklist? If not, then we'll do it by
success criteria. I think you have to do a success criteria and all of its
techniques as one package. I don't think it is feasible to do this work
item by techniques.

I have updated our Team C page [1] so we can track this by success
criteria. As we did last time, please put your name beside the SC on which
you are working.

Thanks!
Andi

[1]
http://trace.wisc.edu/wcag_wiki/index.php?title=Team_C#Ben.27s_Checklist_Work_Items


-----Original Message-----
From: Ben Caldwell [mailto:caldwell@trace.wisc.edu]
Sent: Thursday, March 30, 2006 11:52 am
To: Gregg Vanderheiden; 'John M Slatin'
Subject: Notes on Wiki Cleanup

Hi guys,

Here's a start for a wiki cleanup checklist that I'd like to get some
help from teams a, b and c on. I'm hoping that the more we can do to
have the wiki in the best shape possible before I start the conversion
to XML, the more smoothly and quickly everything will be ready for
publication.

General:

- Have survey comments been incorporated?
- Has the draft been approved for publication?
- Have inline comments been removed?
- Are there links to techniques or how to meet documents that should be
deleted?
- Are there any spelling, punctuation or grammatical mistakes or broken
links that need to be fixed?

How to Meet:

- Is the SC numbering consistent with the latest guidelines draft?
- Is the string, "[DRAFT]" included before each link to techniques that
have not been approved/completed for publication? (Note this is a new
requirement that the Wiki2XML converter will use to determine whether a
link should be active or not)
- Does the How to Meet document include up-to-date Technique titles?
- Is there at least one sufficient technique for each situation ready
for publication?
- Are all listed failures ready for publication?

Techniques:

- Do the headings match those in the Techniques Template [1]?
- Is the technique categorized correctly [2] (ex. [[Category:Tech
Techniques]])?

Anything to add? I'd really appreciate any help I can get in getting
through this as I need to be able to focus on the XML and XSLT in order
for us to wrap this up ASAP.

Thanks,

-Ben

[1] http://tinyurl.com/dgcd7
[2] http://tinyurl.com/qppeq

--
Ben Caldwell | <caldwell@trace.wisc.edu> Trace Research and Development
Center <http://trace.wisc.edu>

Received on Friday, 31 March 2006 21:12:30 UTC