Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
155 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,155 @@ | ||
| <!DOCTYPE html> | ||
| <html lang="en"> | ||
| <head> | ||
| <meta charset="utf-8" /> | ||
| <title>Language enablement</title> | ||
| <meta name="description" content="Describes the language enablement work of the Internationalization Activity." /> | ||
| <script> | ||
| var f = { } | ||
|
|
||
| // AUTHORS should fill in these assignments: | ||
| f.directory = 'getting-started'+'/'; // the path to this file, not including /International or the file name | ||
| f.filename = 'languagedev'; // the file name WITHOUT extensions | ||
| f.authors = 'Richard Ishida, W3C'; // author(s) and affiliations | ||
| f.previousauthors = ''; // as above | ||
| f.modifiers = ''; // people making substantive changes, and their affiliation | ||
| f.searchString = 'level2-languagedev'; // blog search string - usually the filename without extensions | ||
| f.firstPubDate = '2015-07-20'; // date of the first publication of the document (after review) | ||
| f.lastSubstUpdate = { date:'2020-08-10', time:'12:18'} // date and time of latest substantive changes to this document | ||
| f.status = 'notreviewed'; // should be one of draft, review, published, notreviewed or obsolete | ||
| f.path = '../' // what you need to prepend to a URL to get to the /International directory | ||
|
|
||
| // AUTHORS AND TRANSLATORS should fill in these assignments: | ||
| f.thisVersion = { date:'2020-08-10', time:'12:18'} // date and time of latest edits to this document/translation | ||
| f.contributors = ''; // people providing useful contributions or feedback during review or at other times | ||
| // also make sure that the lang attribute on the html tag is correct! | ||
|
|
||
| // TRANSLATORS should fill in these assignments: | ||
| f.translators = 'xxxNAME, ORG'; // translator(s) and their affiliation - a elements allowed, but use double quotes for attributes | ||
|
|
||
| f.breadcrumb = ''; | ||
|
|
||
| f.additionalLinks = '' | ||
| </script> | ||
| <script src="specdev-data/translations.js"> </script> | ||
| <script src="../javascript/doc-structure/article-dt.js"> </script> | ||
| <script src="../javascript/boilerplate-text/boilerplate-en.js"></script><!--TRANSLATORS must change -en to the subtag for their language!--> | ||
| <script src="../javascript/doc-structure/sitepage.js"> </script> | ||
| <script src="../javascript/articletoc-html5.js"></script> | ||
|
|
||
| <link rel="stylesheet" href="../style/sitepage-2016.css" /> | ||
| <link rel="stylesheet" href="specdev-data/local.css" /> | ||
| <link rel="copyright" href="#copyright"/> | ||
| </head> | ||
|
|
||
| <body> | ||
| <header> | ||
| <nav id="mainNavigation"></nav><script>document.getElementById('mainNavigation').innerHTML = mainNavigation</script> | ||
| </header> | ||
| <h1>Get involved with Language Enablement</h1> | ||
|
|
||
|
|
||
| <section id="sidebarExtras"> | ||
| </section> | ||
|
|
||
|
|
||
| <div id="mainLayout"> | ||
| <section> | ||
| <p>To support local relevance of Web pages and eBook formats we need more local experts to help gather information, to review decisions, and to lobby or support via coding the implementation of local features in browsers and ereaders. If you are one of these people, or know some, please get in touch! The rest of this page will tell you how.</p> | ||
| </section> | ||
|
|
||
|
|
||
|
|
||
| <section id="getting_involved"> | ||
| <h2>How to participate</h2> | ||
|
|
||
| <p>To get started, or if you want a low level of commitment, get involved as a <a href="https://github.com/w3c/i18n-activity/wiki/Layout-task-force-roles/#followercontributor">Follower</a>. This involves simply subscribing to a mailing list and providing occasional insights on the group's GitHub discussion threads.</p> | ||
| <p>How to sign up:</p> | ||
| <ol> | ||
| <li>Look at the <a href="https://www.w3.org/International/groups/">list of groups</a> and find the group(s) you are interested in. </li> | ||
| <li>Take a look at the GitHub home page and the issue list, and check the code of conduct, contributing, and licence information.</li> | ||
| <li>Click on the subscribe link and join the mailing list to set up notifications. You will receive a maximum of one email a day (per group) that has a link to relevant GitHub threads that have received comments or been created.</li> | ||
| <li><a href="https://github.com/join?source=prompt-code&source_repo=w3c%2Falreq">Get a GitHub id</a>, so that you can participate in the discussions (really easy, and not privacy invasive).</li> | ||
| </ol> | ||
| <p>If you have the time and inclination to get involved on a more regular basis, consider joining the group as a <a href="https://github.com/w3c/i18n-activity/wiki/Layout-task-force-roles/#participant">Participant</a>. Participants follow the GitHub activity closely, look for opportunities to provide feedback and suggestions, and attend teleconferences/meetings where possible. They may also contribute text for documents. </p> | ||
| <p>We also welcome applications to take a more active role in the group by taking on responsibility for producing work as an <a href="https://github.com/w3c/i18n-activity/wiki/Layout-task-force-roles/#editor">Editor</a> and/or <a href="https://github.com/w3c/i18n-activity/wiki/Layout-task-force-roles/#co-chair">(Co-)chair</a>.</p> | ||
| <p>To contribute in these ways, contact the <a href="mailto:ishida@w3.org">W3C staff contact</a>.</p> | ||
| </section> | ||
|
|
||
| <div style="clear: both;"> | ||
|
|
||
|
|
||
|
|
||
|
|
||
| <section id="resources"> | ||
| <h2><a href="#advice">How things work</a></h2> | ||
| <dl> | ||
| <dt>Github discussions</dt> | ||
| <dd> | ||
| <p>It's really easy for non-technical people to use GitHub issues for discussion.</p> | ||
| <p>All technical discussion should take place in GitHub issues, and not on the mailing lists, since they help us manage conversations. Here's an example of a <a href="https://github.com/w3c/sealreq/issues">discussion list for the Southeast Asian group</a>.</p> | ||
| <p>It's ok to use languages other than English in a GitHub thread, but important information should eventually be summarised in English for the benefit of those who don't speak the language.</p> | ||
| <p>Those new to GitHub may wish to read a short introduction: <a href="https://w3c.github.io/i18n-activity/guidelines/issues.html">Working with GitHub issues</a>.</p> | ||
| </dd> | ||
| <dt>Describing gaps</dt> | ||
| <dd> | ||
| <p>The key deliverable of an lreq group is one or more <strong>gap-analysis documents</strong>. See the <a href="https://w3c.github.io/jlreq/gap-analysis/">Japanese gap-analysis document</a>, for example.</p> | ||
| <p>These documents use a standardised set of headings down to the 3rd level, and then the detailed content is added topic by topic. There is a set of ideas at the beginning of each section, in italics, to suggest things to cover in each section.</p> | ||
| <p>The detailed content of the gap-analysis document is produced using GitHub issues, rather than by editing the HTML. See an <a href="https://github.com/w3c/jlreq/issues/171">example topic for Japanese</a> gap-analysis. The text of the initial comment in an issue is automatically inserted into the HTML document framework. The comment fields lower down the GitHub thread can be used to discuss the current text and/or provide alternative content.</p> | ||
| <p>For details about how to produce a new gap-analysis document, see <a href="https://github.com/w3c/typography/blob/gh-pages/gap-analysis/HOWTO.md">How to contribute to a gap-analysis document</a>.</p> | ||
| <p>The gap-analysis document aims to describe issues and the current state of implementation in specifications or browsers. It's not meant to describe the actual requirements – that is done in a separate document that is technology agnostic. These <strong>requirements documents</strong> can range from the very large <a href="https://w3c.github.io/jlreq/">Japanese Layout Requirements</a>, to small documents that only provide the essential information needed to support the issues raised in the gap-analysis document, such as the <a href="https://w3c.github.io/sealreq/khmer/">Khmer Layout Requirements</a>. These documents are written in HTML.</p> | ||
| </dd> | ||
|
|
||
| <dt>Tests</dt> | ||
| <dd> | ||
| <p>An important part of gap-analysis work involves exploring what features are supported and creating tests that can be used to communicate current behaviour to others.</p> | ||
| <p>The framework we use for our language enablement groups provides a way to quickly create tests and tweak them to explore browser support. For more information about how to create these tests, see <a href="https://github.com/w3c/i18n-tests/wiki/Writing-i18n-tests">Writing i18n tests</a>, and follow the link to the description of <a href="https://github.com/w3c/i18n-tests/wiki/Using-the-interactive-exploratory-tests">Interactive exploratory tests</a>.</p> | ||
| </dd> | ||
| </dl> | ||
| </section> | ||
|
|
||
| </div> | ||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
| <section> | ||
| <h2 id="reviews"><a href="#reviews">Goals of a language enablement group</a></h2> | ||
| <ul> | ||
| <li>Constitute an expert network that the W3C can turn to if they have questions about internationalization of their technologies, or that can raise issues and requirements related to Web technologies.</li> | ||
| <li>Investigate and document situations where people trying to use the Web encounter obstacles for using their own language and writing system. This work should consider whether current standards and implementations provide, or promise support for, the problematic features, and should demonstrate the issues using tests or examples.</li> | ||
| <li>Provide a set of requirements for missing features, or in some cases describe more fully how the language/script should work. This is done in a technology agnostic way.</li> | ||
| <li>Raise bugs and change requests against specifications and applications to encourage support for the features that end users are missing.</li> | ||
| </ul> | ||
| </section> | ||
|
|
||
|
|
||
|
|
||
|
|
||
|
|
||
| <section id="tests"> | ||
| <h2><a href="#tests">More information</a></h2> | ||
|
|
||
| <p>For more information about the language enablement framework that groups use, and useful resources that span the work of all the groups, follow the links on the page <a href="https://w3c.github.io/i18n-drafts/getting-started/languagedev.en" class="highlightLink">Language enablement</a>.</p> | ||
| </section> | ||
| <section id="sponsorship"> | ||
| </section> | ||
|
|
||
| <div class="section"> | ||
| <h2 id="contacts"><a href="#contacts">Contacts</a></h2> | ||
| <ul> | ||
| <li><a href="mailto:ishida@w3.org">Richard Ishida (ishida @ w3. org)</a>, i18n Lead</li> | ||
| <li><a href="mailto:addison@amazon.com">Addison Phillips (addison @ amazon com)</a>, I18n Core Working Group Chair</li> | ||
| <li><a href="mailto:duerst@it.aoyama.ac.jp">Martin Dürst (duerst @ it.aoyama.ac.jp)</a>, i18n Interest Group Chair</li> | ||
| </ul> | ||
| </div> | ||
| </div> | ||
|
|
||
|
|
||
| <br style="clear: both;" /> | ||
|
|
||
| <footer id="thefooter"></footer><script>document.getElementById('thefooter').innerHTML = g.bottomOfPage</script> | ||
| <script>completePage()</script> | ||
| </body> | ||
| </html> |