Add info on styling teletype output in CSS

- dita-ot/dita-ot#4254
- dita-ot/dita-ot#4267

Signed-off-by: Roger Sheen <[email protected]>

release-notes/index.dita

@@ -94,18 +94,20 @@
             <xref href="https://github.com/dita-ot/dita-ot/issues/4064" format="html" scope="external">#4064</xref>,
             <xref href="https://github.com/dita-ot/dita-ot/issues/4257" format="html" scope="external">#4257</xref>
           </li>
-          <li id="4254">HTML5: Teletype output contains inline style attributes
-            <xref href="https://github.com/dita-ot/dita-ot/issues/4254" format="html" scope="external">#4254</xref>
-          </li>
+          <li id="4254">The HTML5 plug-in has been updated to remove the remaining inline style attributes that
+            prevented custom plug-ins from overriding the monospace font presentation of teletype
+              <xmlelement>tt</xmlelement> elements. These changes move the default teletype styling to CSS to allow
+            users to override the presentation in custom stylesheets. The output is visually equivalent to the results
+            generated by previous toolkit versions.
+            <xref href="https://github.com/dita-ot/dita-ot/issues/4254" format="html" scope="external">#4254</xref>,
+            <xref href="https://github.com/dita-ot/dita-ot/issues/4267" format="html" scope="external">#4267</xref>
+          </li>          
           <li id="4259">Improve preprocess unit tests
             <xref href="https://github.com/dita-ot/dita-ot/issues/4259" format="html" scope="external">#4259</xref>
           </li>
           <li id="4264">Add preprocess integration test for subject scheme
             <xref href="https://github.com/dita-ot/dita-ot/issues/4264" format="html" scope="external">#4264</xref>
           </li>
-          <li id="4267">Move teletype styling to Sass partial
-            <xref href="https://github.com/dita-ot/dita-ot/issues/4267" format="html" scope="external">#4267</xref>
-          </li>
           <li id="4269">Footnote in <xmlelement>title</xmlelement>, footnote text appears in <xmlelement
             >xref</xmlelement>
             <xref href="https://github.com/dita-ot/dita-ot/issues/4269" format="html" scope="external">#4269</xref>

resources/source-files.ditamap

@@ -109,6 +109,7 @@
   <keydef keys="migrating-to-3.6" href="../topics/migrating-to-3.6.dita"/>
   <keydef keys="migrating-to-3.7" href="../topics/migrating-to-3.7.dita"/>
   <keydef keys="migrating-to-4.0" href="../topics/migrating-to-4.0.dita"/>
+  <keydef keys="migrating-to-4.1" href="../topics/migrating-to-4.1.dita"/>
   <keydef keys="migration" href="../topics/migration.dita"/>
   <keydef keys="other-errors" href="../topics/other-errors.dita"/>
   <keydef keys="output-formats" href="../topics/output-formats.dita"/>

topics/migrating-to-4.1.dita

@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">
+<!--  This file is part of the DITA Open Toolkit project. See the accompanying LICENSE file for applicable license.  -->
+<reference id="migrating-to-4.1">
+
+  <title>Migrating to release 4.1</title>
+  <titlealts>
+    <navtitle>To 4.1</navtitle>
+  </titlealts>
+
+  <shortdesc>DITA-OT 4.1 includes <ph id="summary">a new version of the Lightweight DITA plug-in with significant
+      enhancements to Markdown processing, and updates for the latest DITA 2.0 draft standard</ph>.</shortdesc>
+
+  <refbody>
+    <section>
+      <note>This topic provides a summary of changes in DITA-OT 4.1 that may require modifications to custom stylesheets
+        or plug-ins. For more information on changes in this release, see the
+        <xref keyref="4.1-release-notes"/>.</note>
+    </section>
+
+    <section id="4.1-inline-styles">
+      <title>Legacy <xmlelement>tt</xmlelement> style attributes moved to CSS</title>
+      <indexterm><xmlelement>tt</xmlelement> styles</indexterm>
+      <p>The HTML5 plug-in has been updated to remove the remaining inline style attributes that prevented custom
+        plug-ins from overriding the monospace font presentation of teletype <xmlelement>tt</xmlelement> elements.</p>
+      <p>These changes move the default teletype styling to CSS to allow users to override the presentation in custom
+        stylesheets. The output is visually equivalent to the results generated by previous toolkit versions.</p>
+      <note type="important">In publishing environments that do not use the default common CSS files, these styles may
+        need to be implemented in custom stylesheets.</note>
+    </section>
+  </refbody>
+</reference>

topics/migration.ditamap

@@ -4,6 +4,7 @@
 <map>
   <title>Migrating customizations</title>
   <topicref keyref="migration">
+    <topicref keyref="migrating-to-4.1"/>
     <topicref keyref="migrating-to-4.0"/>
     <topicref keyref="migrating-to-3.7"/>
     <topicref keyref="migrating-to-3.6"/>