Update migration doc

Author: JayPanoz

docs/CSS02-quickstart.md

@@ -118,7 +118,8 @@ Other scripts are available:
 - `build:ltr` for default stylesheets (Left to Right);
 - `build:rtl` for Right to Left stylesheets;
 - `build:cjk` for CJK scripts;
-- `build:vertical` for CJK and the Mongolian scripts in vertical writing.
+- `build:vertical` for CJK and the Mongolian scripts in vertical writing;
+- `build:web` for Web Publications stylesheets.
 
 ### Additional info
 

docs/CSS28-migration_guide.md

@@ -231,4 +231,30 @@ The 5 following custom properties are available:
 - `--RS__scrollPaddingLeft`
 - `--RS__scrollPaddingRight`
 
-They accept the same values as the CSS property `padding`.
+They accept the same values as the CSS property `padding`.
+
+## Ligatures moved to the global space
+
+As of version `2.0.0-beta.21`, ligatures are no longer limited to RTL (arabic and farsi scripts). The setting is now available in Latin scripts as well.
+
+## Experimental Web Publications stylesheet
+
+As of version `2.0.0-beta.21`, ReadiumCSS provides an experimental stylesheet for Web Publications. It ships with the following features:
+
+- font-family
+- font variations (weight, width, optical-sizing)
+- hyphens
+- letter spacing
+- ligatures
+- line height
+- paragraph indent
+- paragraph spacing
+- Ruby annotations disabling
+- text alignment
+- text normalization
+- word spacing
+- zoom
+
+As well as the patching of zoom for iOS and iPadOS. **Note there is no fallback in case the `zoom` CSS property is not supported.**
+
+Typically, you would use zoom for all web publications, and the rest of the styles if the web publication’s accessibility metadata contains feature `displayTransformability`.

docs/ReadiumCSS_docs.epub

@@ -161,7 +161,9 @@
 
           <li><code>build:cjk</code> for CJK scripts;</li>
 
-          <li><code>build:vertical</code> for CJK and the Mongolian scripts in vertical writing.</li>
+          <li><code>build:vertical</code> for CJK and the Mongolian scripts in vertical writing;</li>
+
+          <li><code>build:web</code> for Web Publications stylesheets.</li>
         </ul>
       </section>
 

docs/ReadiumCSS_docs/OEBPS/Text/Section-002.xhtml

@@ -281,6 +281,34 @@ const backgroundColor = defaultColors.RS__backgroundColor;</code></pre>
 
       <p>They accept the same values as the CSS property <code>padding</code>.</p>
     </section>
+
+    <section id="ligatures-moved" class="level2">
+      <h2 id="sigil_toc_id_217">Ligatures moved to the global space</h2>
+
+      <p>Since version <code>2.0.0-beta.21</code>, ligatures are no longer limited to RTL (arabic and farsi scripts). The setting is now available in Latin scripts as well.</p>
+    </section>
+
+    <section id="experimental-web-publications-stylesheet" class="level2">
+      <h2 id="sigil_toc_id_218">Experimental Web Publications stylesheet</h2>
+
+      <p>Since version <code>2.0.0-beta.21</code>, ReadiumCSS provides an experimental stylesheet for Web Publications. It ships with the following features:</p>
+
+      <ul>
+        <li>font-family</li>
+        <li>font variations (weight, width, optical-sizing)</li>
+        <li>hyphens</li>
+        <li>letter spacing</li>
+        <li>ligatures</li>
+        <li>line height</li>
+        <li>paragraph indent</li>
+        <li>paragraph spacing</li>
+        <li>Ruby annotations disabling</li>
+      </ul>
+
+      <p>As well as the patching of zoom for iOS and iPadOS. <strong>Note there is no fallback in case the <code>zoom</code> CSS property is not supported.</strong></p>
+
+      <p>Typically, you would use zoom for all web publications, and the rest of the styles if the web publication’s accessibility metadata contains feature <code>displayTransformability</code>.</p>
+    </section>
   </section>
 </body>
 </html>

docs/ReadiumCSS_docs/OEBPS/Text/Section-028.xhtml

@@ -753,6 +753,12 @@
         <li>
           <a href="../Text/Section-028.xhtml#sigil_toc_id_216">Addition of scroll-padding module</a>
         </li>
+        <li>
+          <a href="../Text/Section-028.xhtml#sigil_toc_id_217">Ligatures moved to the global space</a>
+        </li>
+        <li>
+          <a href="../Text/Section-028.xhtml#sigil_toc_id_218">Experimental Web Publications stylesheet</a>
+        </li>
       </ol>
       </li>
     </ol>

docs/ReadiumCSS_docs/OEBPS/Text/nav.xhtml

@@ -1377,6 +1377,18 @@
         </navLabel>
         <content src="Text/Section-028.xhtml#sigil_toc_id_216"/>
       </navPoint>
+      <navPoint id="navPoint229">
+        <navLabel>
+          <text>Ligatures moved to the global space</text>
+        </navLabel>
+        <content src="Text/Section-028.xhtml#sigil_toc_id_217"/>
+      </navPoint>
+      <navPoint id="navPoint230">
+        <navLabel>
+          <text>Experimental Web Publications stylesheet</text>
+        </navLabel>
+        <content src="Text/Section-028.xhtml#sigil_toc_id_218"/>
+      </navPoint>
     </navPoint>
   </navMap>
 </ncx>