Fix HTML warnings

garydgregory · garydgregory · commit abe64adbfc28 · 2025-01-23T10:54:04.000-05:00
- Fix spelling
- Use paragraph
- Use a list instead of line breaks
diff --git a/DEVELOPERS-GUIDE.html b/DEVELOPERS-GUIDE.html
@@ -20,21 +20,19 @@
 </head>
 <body>
 
-
-<div align="center">
+<div>
 <h1>The Apache Commons <em>Collections</em> Package</h1>
-<h2>Developers Guide</h2>
-<a href="#Introduction">[Introduction]</a>
-<a href="#CollectionInterfaces">[Collection Interfaces]</a>
-<a href="#CollectionImplementations">[Collection Implementations]</a>
-<a href="#UtilityClasses">[Utility Classes]</a>
-<a href="#CodingStandards">[Coding Standards]</a>
-<br />
-<br />
+<h2>Developer's Guide</h2>
+<ol>
+  <li><a href="#Introduction">Introduction</a></li>
+  <li><a href="#CollectionInterfaces">Collection Interfaces</a></li>
+  <li><a href="#CollectionImplementations">Collection Implementations</a></li>
+  <li><a href="#UtilityClasses">Utility Classes</a></li>
+  <li><a href="#CodingStandards">Coding Standards</a></li>
+</ol>
 </div>
 
-
-<a name="Introduction"></a>
+<a id="Introduction"></a>
 <h3>1.  INTRODUCTION</h3>
 
 <p>The <em>Collections</em> package contains a set of Java classes that extend
@@ -47,7 +45,7 @@ <h3>1.  INTRODUCTION</h3>
 java.util.Collections.</p>
 
 
-<a name="CollectionInterfaces"></a>
+<a id="CollectionInterfaces"></a>
 <h3>2.  COLLECTION INTERFACES</h3>
 
 <p>Collection interfaces are new types of collections not included in Java.
@@ -59,7 +57,7 @@ <h3>2.  COLLECTION INTERFACES</h3>
 </ul>
 
 
-<a name="CollectionImplementations"></a>
+<a id="CollectionImplementations"></a>
 <h3>3.  COLLECTION IMPLEMENTATIONS</h3>
 
 <p>Collection implementation are new implementations of collection interfaces.
@@ -75,7 +73,7 @@ <h3>3.  COLLECTION IMPLEMENTATIONS</h3>
 </ul>
 
 
-<a name="UtilityClasses"></a>
+<a id="UtilityClasses"></a>
 <h3>4.  UTILITY CLASSES</h3>
 
 <p>Utility classes provide additional functionality around an interface and
@@ -111,7 +109,7 @@ <h3>4.  UTILITY CLASSES</h3>
 the constructors should be protected and a public static decorate() method
 provided on each class for construction.</p>
 
-<a name="CodingStandards"></a>
+<a id="CodingStandards"></a>
 <h3>5. CODING STANDARDS</h3>
 
 <p>Commons Collections follows similar style rules to many other Java open source
diff --git a/src/site/xdoc/index.xml b/src/site/xdoc/index.xml
@@ -74,8 +74,10 @@ The <a href="scm.html">source repository</a> can be
 <section name="Releases">
 <p>
 The latest version is available:
-<a href="https://commons.apache.org/collections/download_collections.cgi">Download now!</a><br />
-It is built for Java 8 and later, and the <a href="/changes.html">release notes</a> are also available.
+<a href="https://commons.apache.org/collections/download_collections.cgi">Download now!</a>
+</p>
+<p>
+  This requires Java 8 or later, see also the <a href="/changes.html">release notes</a>.
 </p>
 <p>
 For previous releases, see the <a href="https://archive.apache.org/dist/commons/collections/">Apache Archive</a>
diff --git a/src/site/xdoc/release_3_2.xml b/src/site/xdoc/release_3_2.xml
@@ -47,8 +47,10 @@ This release is fully source and binary compatible with 3.1.
 Please check the bug fixes to ensure you weren't relying on the behavior of a bug.
 </p>
 <p>
-There are two new <i>deprecations</i>:<br />
-BeanMap is now deprecated and will be removed in 4.0.
+There are two new <i>deprecations</i>:
+</p>
+<p>
+BeanMap is deprecated and will be removed in 4.0.
 The class is now available in commons-beanutils (full jar version).
 This change was made to ensure that all bean related collections were in one place (i.e. beanutils).
 If this causes major headaches to anyone please contact commons-dev at jakarta.apache.org.
