Skip to content

Commit

Permalink
Merge remote-tracking branch 'refs/remotes/origin/gh-pages' into gh-p…
Browse files Browse the repository at this point in the history
…ages
  • Loading branch information
xfq committed Nov 7, 2024
2 parents c6d5c3c + 67d862a commit 55ef030
Show file tree
Hide file tree
Showing 3 changed files with 85 additions and 56 deletions.
84 changes: 54 additions & 30 deletions guidelines/le-labels.html
Original file line number Diff line number Diff line change
Expand Up @@ -65,7 +65,6 @@ <h1>How to use GitHub labels in Language Enablement repos</h1>
<section id="question">
<h2>Question</h2>
<p>The <span class="highlight1"><span style="background-color: #cc317c; padding:2px 4px; border-radius:5px; color:white; font-style:normal;font-weight: bold; white-space: nowrap;">question</span></span> label should be attached to every GitHub issue that asks a question of the expert community about how a script works.</p>
<p>Issues with this label are also tracked in the i18n WG tracker repository.</p>
</section>


Expand All @@ -77,7 +76,7 @@ <h2>Gap</h2>
<p>When using this label, you need to also use the following:</p>
<ul>
<li>a <span class="highlight1"><span style="background-color: #c2e0c6; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">doc:</span></span> label</li>
<li>an <span class="highlight1"><span style="background-color: #fbca04; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:</span></span> label</li>
<li>an <span class="highlight1"><span style="background-color: #fef2c0; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:</span></span> label</li>
<li>a <span class="highlight1"><span style="background-color: white; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">p:</span></span> label</li>
</ul>
</section>
Expand Down Expand Up @@ -105,49 +104,74 @@ <h2>P: labels</h2>





<section id="implementation-issue">
<h2>X: labels</h2>

<p>The <span class="highlight1"><span style="background-color: #e99695; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">x:</span></span> label indicates browser engines or W3C technologies affected by a particular gap-analysis issue. It is only used with the <span class="highlight1"><span style="background-color: #e99695; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">gap</span></span> label. These labels should be applied to all gap labelled issues if the technology doesn't resolve the gap. This provides a simple way of filtering the issues in the LE pipeline by technology.</p>
</section>



<section id="schedule-review">
<h2>I: labels</h2>
<p>If you use a <span class="highlight1"><span style="background-color: #e99695; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">gap</span></span> label, you must also use one of these labels. They indicate the section into which the gap-analysis content will be put. The values correspond to sections in the Language Enablement Index, which are the same as those in the gap-analysis documents.</p>
<p>However, it is also recommended that you use these labels with all other technical issues. That makes it possible to filter on a particular type of feature all the issues in the repo.</p>
<p>The values are as follows. The label is shown, followed by the anchor of the relevant section in the Index, and the current title of the Index section (which may change over time).</p>
<p><span class="highlight1"><span style="background-color: #fbca04; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:vertical_text</span></span> #vertical_text, Vertical text</p>
<p><span class="highlight1"><span style="background-color: #fbca04; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:bidirectional_text</span></span> #bidi_text, Bidirectional text</p>
<p><span class="highlight1"><span style="background-color: #fbca04; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:characters_and_encodings</span></span> #charset, Characters &amp; encoding</p>
<p><span class="highlight1"><span style="background-color: #fbca04; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:fonts</span></span> #fonts, Fonts</p>
<p><span class="highlight1"><span style="background-color: #fbca04; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:font_styles_weight_etc</span></span> #font_style, Font styles, weight, etc.</p>
<p><span class="highlight1"><span style="background-color: #fbca04; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:glyph_shaping_positioning</span></span> #glyphs, Glyph shaping &amp; positioning</p>
<p><span class="highlight1"><span style="background-color: #fbca04; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:cursive</span></span> #cursive, Cursive text</p>
<p><span class="highlight1"><span style="background-color: #fbca04; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:vertical_text</span></span> #baseline, Baselines, line height, etc.</p>
<p><span class="highlight1"><span style="background-color: #fbca04; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:transforming_characters</span></span> #transforms, Transforming characters</p>
<p><span class="highlight1"><span style="background-color: #fbca04; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:grapheme_word_segmentation</span></span> #segmentation, Grapheme/word segmentation &amp; selection</p>
<p><span class="highlight1"><span style="background-color: #fbca04; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:inline_features_punctuation</span></span> #punctuation_etc, Inline features &amp; punctuation</p>
<p><span class="highlight1"><span style="background-color: #fbca04; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:text_decoration</span></span> #text_decoration, Text decoration</p>
<p><span class="highlight1"><span style="background-color: #fbca04; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:quotations</span></span> #quotations, Quotations</p>
<p><span class="highlight1"><span style="background-color: #fbca04; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:inline_notes_annotations</span></span> #inline_notes, Inline notes &amp; annotations</p>
<p><span class="highlight1"><span style="background-color: #fbca04; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:data_formats_numbers</span></span> #data_formats, Data formats &amp; numbers</p>
<p><span class="highlight1"><span style="background-color: #fbca04; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:line_breaking</span></span> #line_breaking, Line breaking</p>
<p><span class="highlight1"><span style="background-color: #fbca04; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:hyphenation</span></span> #hyphenation, Hyphenation</p>
<p><span class="highlight1"><span style="background-color: #fbca04; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:text_align_justification</span></span> #justification, Text alignment &amp; justification</p>
<p><span class="highlight1"><span style="background-color: #fbca04; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:letter_spacing</span></span> #spacing, Letter spacing</p>
<p><span class="highlight1"><span style="background-color: #fbca04; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:lists_counters_etc</span></span> #lists, Lists, counters, etc.</p>
<p><span class="highlight1"><span style="background-color: #fbca04; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:styling_initials</span></span> #initials, Styling initials</p>
<p><span class="highlight1"><span style="background-color: #fbca04; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:page_layout_progression</span></span> #page_layout, General page layout &amp; progression</p>
<p><span class="highlight1"><span style="background-color: #fbca04; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:footnotes_endnotes_etc</span></span> #footnotes_etc, Footnotes, endnotes, etc.</p>
<p><span class="highlight1"><span style="background-color: #fbca04; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:page_headers_footers_etc</span></span> #headers_footers, Page headers, footers, etc.</p>
<p><span class="highlight1"><span style="background-color: #fbca04; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:forms_user_interaction</span></span> #interaction, Forms &amp; user interaction</p>
<p>The values are as follows. The label is shown, followed by the current title of the sections in the LE Index and the LReq pages (which may change over time).</p>

<p><mark>Text direction</mark></p>
<p><span class="highlight1"><span style="background-color: #fef2c0; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:vertical_text</span></span> Vertical text</p>
<p><span class="highlight1"><span style="background-color: #fef2c0; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:bidi_text</span></span> Bidirectional text</p>

<p><mark>Glyph shaping &amp; positioning</mark></p>
<p><span class="highlight1"><span style="background-color: #fef2c0; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:fonts</span></span> #fonts, Fonts &amp; font styles</p>
<p><span class="highlight1"><span style="background-color: #fef2c0; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:glyphs</span></span> Context-based shaping &amp; positioning</p>
<p><span class="highlight1"><span style="background-color: #fef2c0; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:cursive</span></span> Cursive text</p>
<p><span class="highlight1"><span style="background-color: #fef2c0; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:letterforms</span></span> Letterform slopes, weights, &amp; italics.</p>
<p><span class="highlight1"><span style="background-color: #fef2c0; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:transforms</span></span> Transforming characters</p>

<p><mark>Typographic units</mark></p>
<p><span class="highlight1"><span style="background-color: #fef2c0; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:encoding</span></span> Characters &amp; encoding</p>
<p><span class="highlight1"><span style="background-color: #fef2c0; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:segmentation</span></span> Grapheme/word segmentation &amp; selection</p>

<p><mark>Punctuation &amp; inline features</mark></p>
<p><span class="highlight1"><span style="background-color: #fef2c0; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:punctuation_etc</span></span> Phrase &amp; section boundaries</p>
<p><span class="highlight1"><span style="background-color: #fef2c0; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:quotations</span></span> Quotations &amp; citations</p>
<p><span class="highlight1"><span style="background-color: #fef2c0; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:emphasis</span></span> Emphasis &amp; highlighting</p>
<p><span class="highlight1"><span style="background-color: #fef2c0; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:abbrev</span></span> Abbreviation, ellipsis, &amp; repetition</p>
<p><span class="highlight1"><span style="background-color: #fef2c0; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:inline_notes</span></span> Inline notes &amp; annotations</p>
<p><span class="highlight1"><span style="background-color: #fef2c0; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:text_decoration</span></span> Other inline features</p>
<p><span class="highlight1"><span style="background-color: #fef2c0; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:data_formats</span></span> Data formats &amp; numbers</p>

<p><mark>Line &amp; paragraph layout</mark></p>
<p><span class="highlight1"><span style="background-color: #fef2c0; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:line_breaking</span></span> Line breaking</p>
<p><span class="highlight1"><span style="background-color: #fef2c0; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:hyphenation</span></span> Hyphenation (this should always be in addition to i:line_breaking!)</p>
<p><span class="highlight1"><span style="background-color: #fef2c0; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:justification</span></span> Text alignment &amp; justification</p>
<p><span class="highlight1"><span style="background-color: #fef2c0; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:spacing</span></span> Text spacing</p>
<p><span class="highlight1"><span style="background-color: #fef2c0; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:baselines</span></span> Baselines, line height, etc.</p>
<p><span class="highlight1"><span style="background-color: #fef2c0; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:lists</span></span> Lists, counters, etc.</p>
<p><span class="highlight1"><span style="background-color: #fef2c0; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:initials</span></span> Styling initials</p>

<p><mark>Page &amp; book layout</mark></p>
<p><span class="highlight1"><span style="background-color: #fef2c0; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:page_layout</span></span> General page layout &amp; progression</p>
<p><span class="highlight1"><span style="background-color: #fef2c0; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:grids</span></span> Grids &amp; tables.</p>
<p><span class="highlight1"><span style="background-color: #fef2c0; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:footnotes_etc</span></span> Footnotes, endnotes, etc.</p>
<p><span class="highlight1"><span style="background-color: #fef2c0; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:headers_footers</span></span> Page headers, footers, etc.</p>
<p><span class="highlight1"><span style="background-color: #fef2c0; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">i:interaction</span></span> Forms &amp; user interaction</p>
</section>


<section id="notify">
<h2>Useful-discussion</h2>
<h2>l: labels</h2>
<p>These <span class="highlight1"><span style="background-color: #d4c5f9; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">l:</span></span> labels indicate the language(s) that are relevant to the issue thread. They can be used to filter the issues for a particular language.</p>
<p>A repository that only works on a single language may not use this label.</p>
<p>It's recommended to add this label to all technical discussions.</p>
</section>


<section id="useful">
<h2>l: labels</h2>
<h2>Useful-discussion</h2>
<p>The <span class="highlight1"><span style="background-color: #fce8c4; padding:2px 4px; border-radius:5px; color:black;font-style:normal;font-weight: bold; white-space: nowrap;">useful-discussion</span></span> label can be added to a technical discussion that contains useful information, pictures, example, etc. It is especially useful if not all that information will find its way into a document, since the Language Enablement Index points to useful discussion threads.</p>
</section>

Expand Down
9 changes: 7 additions & 2 deletions i18n-wg/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -102,11 +102,16 @@ <h2>Organization</h2>
<section id="communication">
<h2>Electronic communication</h2>

<p>The main points of entry for information and news related to the work of the Internationalization Working Group are the home page and twitter channel.</p>
<p>The main points of entry for information and news related to the work of the Internationalization Working Group are the home page and social networking channels.</p>

<p class="highlightLink"><a target="_blank" href="https://www.w3.org/International/">I18n Home Page</a></p>

<p class="highlightLink"><a href="https://twitter.com/webi18n">@webi18n</a></p>
<p class="highlightLink"><a href="https://w3c.social/@webi18n">@webi18n</a>&nbsp; <a href="https://w3c.social/@webi18n" title="Mastodom stream."><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" fill="rgb(29,141,238)" class="bi bi-mastodon" viewBox="0 0 16 16">
<path d="M11.19 12.195c2.016-.24 3.77-1.475 3.99-2.603.348-1.778.32-4.339.32-4.339 0-3.47-2.286-4.488-2.286-4.488C12.062.238 10.083.017 8.027 0h-.05C5.92.017 3.942.238 2.79.765c0 0-2.285 1.017-2.285 4.488l-.002.662c-.004.64-.007 1.35.011 2.091.083 3.394.626 6.74 3.78 7.57 1.454.383 2.703.463 3.709.408 1.823-.1 2.847-.647 2.847-.647l-.06-1.317s-1.303.41-2.767.36c-1.45-.05-2.98-.156-3.215-1.928a3.614 3.614 0 0 1-.033-.496s1.424.346 3.228.428c1.103.05 2.137-.064 3.188-.189zm1.613-2.47H11.13v-4.08c0-.859-.364-1.295-1.091-1.295-.804 0-1.207.517-1.207 1.541v2.233H7.168V5.89c0-1.024-.403-1.541-1.207-1.541-.727 0-1.091.436-1.091 1.296v4.079H3.197V5.522c0-.859.22-1.541.66-2.046.456-.505 1.052-.764 1.793-.764.856 0 1.504.328 1.933.983L8 4.39l.417-.695c.429-.655 1.077-.983 1.934-.983.74 0 1.336.259 1.791.764.442.505.661 1.187.661 2.046v4.203z"></path>
</svg></a>&nbsp;

<a href="https://x.com/webi18n" title="X stream."><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 50 50" width="20px" height="20px"><path d="M 11 4 C 7.134 4 4 7.134 4 11 L 4 39 C 4 42.866 7.134 46 11 46 L 39 46 C 42.866 46 46 42.866 46 39 L 46 11 C 46 7.134 42.866 4 39 4 L 11 4 z M 13.085938 13 L 21.023438 13 L 26.660156 21.009766 L 33.5 13 L 36 13 L 27.789062 22.613281 L 37.914062 37 L 29.978516 37 L 23.4375 27.707031 L 15.5 37 L 13 37 L 22.308594 26.103516 L 13.085938 13 z M 16.914062 15 L 31.021484 35 L 34.085938 35 L 19.978516 15 L 16.914062 15 z"></path></svg></a>
<!-- Icons by https://icons8.com--></p>

<p>The news is also sent to various <a href="https://www.w3.org/International/i18n-drafts/nav/follow#feeds">RSS feeds</a>.</p>

Expand Down
Loading

0 comments on commit 55ef030

Please sign in to comment.