gap-analysis/guru-gap Update front matter

r12a · r12a · commit 21ec7330f961 · 2024-07-10T05:38:54.000+01:00
diff --git a/gap-analysis/guru-gap.html b/gap-analysis/guru-gap.html
@@ -14,17 +14,12 @@
       // specification status (e.g. WD, LCWD, WG-NOTE, etc.). If in doubt use ED.
       specStatus:           "ED",
       //publishDate:  		"2020-06-16",
-      //previousPublishDate:  "2014-12-16",
-      //previousMaturity:  "FPWD",
 
       noRecTrack:           true,
       shortName:            "guru-gap",
       copyrightStart:       "2018",
       edDraftURI:           "https://w3c.github.io/iip/gap-analysis/guru-gap",
 
-      // if this is a LCWD, uncomment and set the end of its review period
-      // lcEnd: "2009-08-05",
-
       // editors, add as many as you like
       // only "name" is required
       editors:  [
@@ -66,13 +61,16 @@
 </head>
 
 <body>
-  <div id="abstract">
-    <p>This document describes and prioritises gaps for the support of languages using the Gurmukhi script on the Web and in eBooks. In particular, it is concerned with text layout. It checks that needed features are supported in W3C specifications, in particular HTML and CSS and those relating to digital publications. It also checks whether the features have been implemented in browsers and ereaders. <strong>This is a preliminary analysis.</strong></p>
-  </div>
+<div id="abstract">
+<p>This document describes and prioritises gaps for the support of the Gurmukhi script on the Web and in eBooks. In particular, it is concerned with text layout. It checks that needed features are supported in W3C specifications, such as HTML and CSS and those relating to digital publications. It also checks whether the features have been implemented in browsers and ereaders.</p>
+</div>
+
+
+<div id="sotd">
+<p>This document describes and prioritises gaps for the support of the Gurmukhi script on the Web and in eBooks. In particular, it is concerned with text layout. It checks that needed features are supported in W3C specifications, in particular HTML and CSS and those relating to digital publications. It also checks whether the features have been implemented in browsers and ereaders.
+It is linked to from the <a href="https://www.w3.org/International/typography/gap-analysis/language-matrix.html">language matrix</a> that tracks Web support for many languages.</p>
 
-  <div id="sotd">
-    <p>This document describes and prioritises gaps for the support of languages using the Gurmukhi script on the Web and in eBooks. In particular, it is concerned with text layout. It checks that needed features are supported in W3C specifications, in particular HTML and CSS and those relating to digital publications. It also checks whether the features have been implemented in browsers and ereaders. This document <!--complements the document <a href="https://w3c.github.io/gurmukhi/">Gurmukhi Layout Requirements</a>, which describes the requirements for areas where gaps appear. It--> is linked to from the <a href="https://w3c.github.io/typography/gap-analysis/language-matrix.html">language matrix</a> that tracks Web support for many languages.</p>
-<p>The editor's draft of this document is being developed by the <a href="https://w3c.github.io/iip/">India International Program Layout Task Force</a>, part of the W3C <a href="https://www.w3.org/International/ig/">Internationalization Interest Group</a>. It is published by the <a href="https://www.w3.org/International/core/">Internationalization Working Group</a>. The end target for this document is a Working Group Note.</p>
+<p>The editor's draft of this document is being developed in the GitHub repository <a href="https://w3c.github.io/iip/home">Indian Language Enablement (ilreq)</a>, with contributors from the <abbr title="World Wide Web Consortium">W3C</abbr> <a href="https://www.w3.org/International/i18n-activity/i18n-ig/">Internationalization Interest Group</a>. It is published by the <a href="https://www.w3.org/International/i18n-activity/i18n-wg/">Internationalization Working Group</a>. The end target for this document is a Working Group Note.</p>
 </div>
 
 
@@ -84,20 +82,20 @@
 
 
 
+
+
 <section id="h_introduction">
 <h2>Introduction</h2>
 
 
 <section id="contributors">
 <h2>Contributors</h2>
 
-<p>The original version of this document was created by Akshat Joshi (C-DAC). It was extended by Richard Ishida.</p>
+<p>This document was created by Richard Ishida.</p>
 <!--
-<p>Special thanks to the following people who contributed to this document (contributors' names listed in in alphabetic order).</p>
-
-<p class="acknowledgement">This Person, That Person, etc</p>
+<p>The following people contributed information to the gap reports in this document (in alphabetic order): This Person, That Person, etc</p>
 -->
-<p data-lang="en">Other contributors can be found in the <a href="https://github.com/w3c/iip/graphs/contributors">GitHub contributors list</a>.</p>
+<p data-lang="en">See also the <a href="https://github.com/w3c/iip/graphs/contributors">GitHub contributors list</a> for the Indian Language Enablement project, and the <a href="https://github.com/w3c/iip/issues?q=is%3Aissue+label%3As%3Aguru">discussions related to the Gurmukhi script</a>.</p>
 </section>
 
 
@@ -110,55 +108,61 @@ <h2>About this document</h2>
 
 <p>The W3C needs to make sure that the  needs of scripts and languages around the world are built in to technologies such as HTML, CSS, SVG, etc. so that Web pages and eBooks can look and behave as people expect around the world.</p>
 
-<p>This page documents difficulties people encounter when trying to use the Punjabi language in the Gurmukhi script on the Web. </p>
+<p>This page documents difficulties that people encounter when trying to use languages written in the Gurmukhi script on the Web.</p>
+
 <p>Having identified an issue, it investigates the current status with regards to web specifications and implementations by user agents (browsers, e-readers, etc.), and attempts to prioritise the severity of the issue for web users.</p>
+</section>
 
-<p>A summary of this report and others can be found as part of the <a href="https://w3c.github.io/typography/gap-analysis/language-matrix.html" style="font-size: 140%;">language matrix</a>.</p>
 
 
-<p>For a description of the Gurmukhi script and its use for the Punjabi language see the (non-W3C) page <a href="https://r12a.github.io/scripts/guru/pa.html">Punjabi (Gurmukhi) Orthography Notes</a>, which summarises aspects of the orthography and typographic features, including relevant Unicode characters and their use.</p>
-</section>
 
 
 
 
+<section id="prioritization">
+<h3>Prioritization</h3>
 
+<p>This document not only describes gaps, it also attempts to prioritise them in terms of the impact on the local user. The prioritisation is indicated by colour.</p>
 
-    <section id="workflow">
-    <h3>Work flow</h3>
-    <p><span style="font-weight:bold; font-size: 140%;">This version of the document is a preliminary analysis</span></p>
+<p>Key:</p>
+<ul style="list-style-type: none;">
+<li class="ok"></li>
+<li class="na"></li>
+<li class="advanced"></li>
+<li class="basic"></li>
+<li class="broken"></li>
+<li class="tbd"></li>
+</ul>
 
-    <p>Gap analysis work usually starts with a <strong>preliminary analysis</strong>, conducted quickly by one or a small group of experts. Then a more <strong>detailed analysis</strong> is carried out, involving a wider range of experts. The detailed analysis may involve the development of tests, in order to illustrate issues and track results for browsers. The next phase is <strong>ongoing maintenance</strong>. It is expected that the resulting document will not be frozen: as gaps are fixed, this should be noted in the document. It is also possible that new gaps are noticed or arise, and they can be added to this document when that happens.</p>
-    
-    <!--p>As the gap analysis develops, the requirements for features that are problematic should be described in the companion document, <a href="https://w3c.github.io/xxxxlreq/">Xxxx Layout Requirements</a>. Links to the appropriate part of that document should be added to this document as the material is created. Note that the requirements document should not contain any technology-specific information: all of that belongs here.</p-->
-    </section>
-    
-    <section id="prioritization">
-    <h3>Prioritization</h3>
-    <p>This document not only describes gaps, it also attempts to prioritise them in terms of the impact on the local user. The prioritisation is indicated by colour.</p>
-        
-        <p>Key:</p>
-  <ul style="list-style-type: none;">
-        <li class="ok"></li>
-        <li class="na"></li>
-        <li class="advanced"></li>
-        <li class="basic"></li>
-        <li class="broken"></li>
-        <li class="tbd"></li>
-        </ul>
-    
-    <p>It is important to note that these colours do not indicate to what extent a particular features is broken. They indicate the impact of a broken or missing feature on the content author or end user.</p>
-    <p>Basic styling is the level that would be generally accepted as sufficient for most Web pages. Advanced level support would include additional features one might expect to include in ebooks or other advanced typographic formats. There may be features of a script or language that are not supported on the Web, but that are not generally regarded as necessary (usually archaic or obscure features). In this case, the feature can be described here, but the status should be marked as OK.</p>
-    <p>The decision as to what priority level is assigned to a described gap is down to the experts doing the gap analysis. It may not always be straightforward to decide. If a given section in this document refers to more than one feature that is broken, each with different impacts on Web users, the priority for the section should be the lowest denominator.</p>
-    <p>A cell can be scored as OK if the feature in question is specified in an appropriate specification, and is supported by user agents. A specification that is in CR or later and has two implementations in 'major' browsers will count. This means that the feature may not be supported in all browsers yet. (At some point in the future we may try to distinguish, visually, whether support is available in a specification but still pending in major browsers or applications.) </p>
-    </section>
+<p>It is important to note that these colours do not indicate to what extent a particular feature is broken. They indicate the impact of a broken or missing feature on the content author or end user.</p>
+
+<p>Basic styling is the level that would be generally accepted as sufficient for most Web pages. Advanced level support would include additional features one might expect to include in ebooks or other advanced typographic formats. There may be features of a script or language that are not supported on the Web, but that are not generally regarded as necessary (usually archaic or obscure features). In this case, the feature can be described here, but the status should be marked as OK.</p>
+
+<p>The decision as to what priority level is assigned to a described gap is down to the experts doing the gap analysis. It may not always be straightforward to decide. If a given section in this document refers to more than one feature that is broken, each with different impacts on Web users, the priority for the section should be the lowest denominator.</p>
+
+<p>A cell can be scored as OK if the feature in question is specified in an appropriate specification, and is supported by user agents. A specification that is in CR or later and has two implementations in 'major' browsers will count. This means that the feature may not be supported in all browsers yet. (At some point in the future we may try to distinguish, visually, whether support is available in a specification but still pending in major browsers or applications.) </p>
 </section>
 
 
 
 
 
 
+<section id="related">
+<h2>Related information</h2>
+
+<p>A summary of this report and others can be found as part of the <a href="https://www.w3.org/International/typography/gap-analysis/language-matrix.html" target="_blank">Language Matrix</a>.</p>
+
+<p>Gap reports are brought to the attention of spec and browser implementers, and are tracked via the <a href="https://github.com/orgs/w3c/projects/95" target="_blank">Gap Analysis Pipeline</a>. (<a href="https://github.com/orgs/w3c/projects/95/views/1?filterQuery=label%3A%22s%3Aguru%22" target="_blank">Filter for Gurmukhi script items</a>)</p>
+
+<p>See also <a href="https://www.w3.org/TR/guru-lreq/" target="_blank">Gurmukhi Script Resources</a> for information about the Gurmukhi script.</p>
+</section>
+</section>
+
+
+
+
+
 
 
 
