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

Re: UAWG Wiki update

From: Jan Richards <jan.richards@utoronto.ca>
Date: Tue, 19 Jun 2007 15:06:57 -0400
Message-ID: <46782951.9000206@utoronto.ca>
To: Peter Parente <pparent@us.ibm.com>
CC: WAI-UA list <w3c-wai-ua@w3.org>

Hi Peter,

Thanks for the suggestion.

I'm not sure about RST. It seems like a lot of work up front and I'm not 
sure it can handle all the styling etc. that the document (even Editor's 
drafts) need.

But maybe this is something we can discuss on Thursday.


Peter Parente wrote:
> 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

Jan Richards, M.Sc.
User Interface Design Specialist
Adaptive Technology Resource Centre (ATRC)
Faculty of Information Studies
University of Toronto

   Email: jan.richards@utoronto.ca
   Web:   http://jan.atrc.utoronto.ca
   Phone: 416-946-7060
   Fax:   416-971-2896
Received on Tuesday, 19 June 2007 19:06:29 UTC

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