W3C home > Mailing lists > Public > w3c-wai-ua@w3.org > April to June 2007

Re: UAWG Wiki update

From: Peter Parente <pparent@us.ibm.com>
Date: Fri, 15 Jun 2007 15:30:15 -0400
To: Jan Richards <jan.richards@utoronto.ca>
Cc: WAI-UA list <w3c-wai-ua@w3.org>, w3c-wai-ua-request@w3.org
Message-ID: <OFE57923A2.24B917B4-ON852572FB.006AA0B8-852572FB.006B2D9B@us.ibm.com>

Hi Jan,

Thanks for setting up the wiki. One suggestion: MoinMoin wiki markup is 
pretty darn ugly. However, MoinMoin does supported reStructuredText (rst) 
format which is designed to be readable even as plain text. It also has 
the bonus of being renderable to (X)HTML (standards compliant), DocBook, 
LaTeX (and hence PDF, PS, etc.), S5, and more, possibly cutting down on 
the amount of editing you need to do when going from the wiki to HTML. (I 
can show you how to render the rst wiki pages into a single, standalone, 
styleable HTML document when the time comes if you'd like.)

Would it be possible to get rst configured on the wiki server? There are 
instructions for doing it on the wiki already at 
http://www.w3.org/WAI/UA/wiki/HelpOnParsers/ReStructuredText and a primer 
on the format at 
http://www.w3.org/WAI/UA/wiki/HelpOnParsers/ReStructuredText/RstPrimer 
(which won't render until you have rst installed of course). 

The main rst and docutils (which does the rendering) website is at 
http://docutils.sourceforge.net/rst.html.

Just an idea,
Pete

Peter Parente
IBM Linux Accessibility Project
pparent@us.ibm.com
Tie: 526-2346
UNC: 919-962-1780
IBM: 919-486-2346



Jan Richards <jan.richards@utoronto.ca> 
Sent by: w3c-wai-ua-request@w3.org
06/15/2007 01:55 PM

To
WAI-UA list <w3c-wai-ua@w3.org>
cc

Subject
UAWG Wiki update







Hi everyone,

The UAAG wiki is up and I'm STARTING to add the UAAG text. To get signed 
up go to:

http://www.w3.org/WAI/UA/wiki/FrontPage

And then create an account. Usually accounts are FirstnameLastname (e.g. 
JanRichards).

Once you have an account name, please email it to me so I can sign you 
up to have edit privileges.

I've been thinking about the best way to use the wiki...since there 
needs to a balance between several factors:

1. Don't want pages to be too big.
2. Don't want too many pages since it makes compiling them into an 
Editor's draft too difficult.
3. The wiki loses formatting so I don't want the WHOLE document to be on 
the wiki - since then I will have to reformat the whole thing for each 
Editor's draft.

So here's what I'm thinking...

We have a main TOC page (http://www.w3.org/WAI/UA/wiki/UaagDocument) and 
make wiki pages for each Checkpoint (1.1,1.2, etc.). That way we can 
play with the organization on the main page and update the checklist 
wordings on the individual pages.

Alternatively we could have a wiki page for the group of checkpoints 
under each guideline.

If you have any other thoughts please let me know.

Cheers,
Jan
Received on Friday, 15 June 2007 19:30:35 UTC

This archive was generated by hypermail 2.3.1 : Wednesday, 7 January 2015 14:49:35 UTC