[WG: I18N & L10N] Accessibility help documentation being changed

Neal Caidin nealcaidin at sakaifoundation.org
Mon Mar 25 13:23:12 PDT 2013

Thanks Beth!

So, how do proposals work for Accessibility and Internationalization groups? Is it similar to the TCC process or does each group have their own? 

Proposal to a11y and i18n/l10n groups:

1) The a11y group will maintain a wiki page on confluence.sakaiproject.org that will serve as a portal for all accessibility information and related translations. It will have a link to the Sakai 2.9 accessibility documentation, a set of links to 2.9 Help translations, a link to 2.8 accessibility information and a set of links to the 2.8 Help translations. It will also contain the Sakai Accessibility Statement and Accessibility support contact information, which should be included on all the translation wiki pages. 

2) Major releases will have their own wiki page, which will be linked from the main or "portal" page. As per TCC policy, only the two most recent major releases will be supported and documentation maintained. 

3) The assumption is that it should be rare for point releases to require updates to Accessibility Help documentation, but in this case the Accessibility group will indicate the change and notify the Internationalization group through the i18n at collab.sakaiproject.org email group. 

4) Translations will be maintained as child pages underneath the release to which they relate, that is 2.9 translations will exist as child pages underneath the 2.9 English Accessibility Help translation. 2.8 translations will be maintained underneath the 2.8 English Accessibility Help.

For a description of the TCC "lazy consensus" process see - https://confluence.sakaiproject.org/display/TCC/TCC+Governance

Please if the chair from each group could let me know the best way to get a decision made, please let me know.


Neal Caidin

Sakai CLE Community Coordinator
nealcaidin at sakaifoundation.org
Skype: nealkdin
AIM: ncaidin at aol.com

On Mar 25, 2013, at 9:31 AM, Beth Kirschner <bkirschn at umich.edu> wrote:

> My 2-cents: I think that the a11y should have a proposal for how to translate the new help page before moving forward, but I don't think this has to be a huge roadblock. There should also be a proposal for how to handle version-specific changes. Here's a simple straw-man proposal:
> 1. Major releases (e.g. 2.9) have their own wiki page, as suggested below
> 2. Minor releases (e.g. 2.9.1) should be called out within the text of the page, as appropriate (e.g. Known problems include risk of catching a gullibility virus, which has been fixed in 2.9.2).
> 3. Links to translations are provided at the _top_ of the page, and created as child pages. The "How to Translate Sakai" page should be updated (https://confluence.sakaiproject.org/display/I18N/How+to+Translate+Sakai)
> - Beth
> On Mar 22, 2013, at 11:23 AM, Neal Caidin <nealcaidin at sakaifoundation.org> wrote:
>> Hi a11y group and i18n/localization, 
>> For those of you not aware, a11y has decided to move the Accessibilty help information out of the online help tool and into an external wiki (Confluence), at least until such time as the direction of the Online Help tool is decided (there has been some discussion about possibly replacing with this - https://confluence.sakaiproject.org/display/HELP/Future+plans+for+The+Knowledge+Base+Tool  , but no decision) . 
>> By making this change, updates to Accessibility information for Sakai can be made more frequently and dynamically as needed. 
>> Here is the proposed text that would go into Sakai CLE online help, and point back to the wiki:  "The following URL is provided for people with disabilities who would like to experience the accessibility enhancements of Sakai.
>> https://confluence.sakaiproject.org/display/2ACC/Sakai+2.9+Accessibility+Help+Documentation"
>> So the question is, would it be okay to proceed with this change and figure out the localization process afterwards (aka translation) or do we need to figure this out before making the change? 
>> An easy solution could be that the Accessibility wiki page could contain any links to localized translations which are provided to the Accessibiity group, as they are created. So there is still one page for the community to reference to find information about Accessibility in any language (at least acting like a "portal").
>> FWIW, there appear to only be two translations of the current Accessiblity information in CLE: Brazilian Portuguese and Traditional Chinese.
>> What do you think?
>> Thanks!
>> Neal Caidin
>> Sakai CLE Community Coordinator
>> nealcaidin at sakaifoundation.org
>> Skype: nealkdin
>> AIM: ncaidin at aol.com
>> _______________________________________________
>> i18n mailing list
>> i18n at collab.sakaiproject.org
>> http://collab.sakaiproject.org/mailman/listinfo/i18n
>> TO UNSUBSCRIBE: send email to i18n-unsubscribe at collab.sakaiproject.org with a subject of "unsubscribe"

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://collab.sakaiproject.org/pipermail/i18n/attachments/20130325/ff3af73e/attachment.html 

More information about the i18n mailing list