Favor JDKs & add package managers as Java sources

Signed-off-by: Roger Sheen <[email protected]>
dita-ot · Feb 29, 2024 · bb6d74f · bb6d74f
1 parent 3af60fe
commit bb6d74f
Show file tree

Hide file tree

Showing 3 changed files with 26 additions and 2 deletions.
diff --git a/resources/external-links.ditamap b/resources/external-links.ditamap
@@ -859,6 +859,16 @@
         <linktext>CommonMark</linktext>
       </topicmeta>
     </keydef>
+    <keydef
+      keys="chocolatey"
+      href="https://chocolatey.org/"
+      scope="external"
+      format="html"
+    >
+      <topicmeta>
+        <linktext>Chocolatey</linktext>
+      </topicmeta>
+    </keydef>
     <keydef
       keys="dita-adoption-tc"
       href="https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=dita-adoption"
@@ -1029,6 +1039,16 @@
         <linktext>Sass</linktext>
       </topicmeta>
     </keydef>
+    <keydef
+      keys="sdkman"
+      href="https://sdkman.io/jdks"
+      scope="external"
+      format="html"
+    >
+      <topicmeta>
+        <linktext>SDKMAN!</linktext>
+      </topicmeta>
+    </keydef>
     <keydef
       keys="python-markdown-attlists"
       href="https://python-markdown.github.io/extensions/attr_list/"

diff --git a/resources/reusable-components.dita b/resources/reusable-components.dita
@@ -131,14 +131,18 @@
         <indexterm>OpenJDK</indexterm>
         <indexterm>Oracle JDK</indexterm>
         <ul>
-          <li>You can download the Oracle JRE or JDK from
+          <li>You can download Oracle distributions from
             <xref keyref="download.oracle-jdk"/> under commercial license.</li>
           <li>Eclipse Temurin is the free OpenJDK distribution available from
             <xref keyref="download.openjdk"/>.</li>
           <li>Free OpenJDK distributions are also provided by
             <xref keyref="download.openjdk.corretto"/>,
             <xref keyref="download.openjdk.azul"/>, and
             <xref keyref="download.openjdk.redhat"/>.</li>
+          <li>Java versions are also available via package managers such as
+            <xref keyref="chocolatey"/>,
+            <xref keyref="homebrew"/>, or
+            <xref keyref="sdkman"/></li>
         </ul>
       </p>
       <p id="java-bc">

diff --git a/topics/prerequisite-software.dita b/topics/prerequisite-software.dita
@@ -37,7 +37,7 @@
       <p>DITA-OT requires the following software applications:
         <dl>
           <dlentry>
-            <dt>Java Runtime Environment (JRE) or Java Development Kit (JDK)</dt>
+            <dt>Java Development Kit (JDK) or Java Runtime Environment (JRE)</dt>
             <dd>
               <p conkeyref="reusable-components/java-clients"/>
               <note>This is the <i>only</i> prerequisite that you need to install. All other required software is