maintaining.html: Restructure the "Keeping Up" section into two pieces

Split into two parts: the key sources and optional extras.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

1 files changed, 59 insertions, 50 deletions

diff --git a/maintaining.html b/maintaining.html
index 72f0107..8c041b9 100644
--- a/maintaining.html
+++ b/maintaining.html
@@ -193,34 +193,40 @@ Maintaining Linux <em>man-pages</em>
         One of the biggest challenges is keeping up to date with changes in
         the kernel and glibc. 
         There are a few ways to do this.
+	This section lists the things I find most useful.
     </p>
 
 
-<h3>Looking ahead: <em>linux-next</em></h3>
-
-<p>
-    The <a href="https://git.kernel.org/cgit/linux/kernel/git/next/linux-next.git"><em>linux-next</em> tree</a>
-    is the holding area for patches aimed at the next kernel merge window.
-    It can be useful to track what's going on there,
-    in order to get some idea of upcoming changes to the kernel.
-    (<a href="linux-next.html">Some notes on working with <em>linux-next</em></a>.)
-</p>
-
-<h3>Git</h3>
+<h3>Websites</h3>
 
     <p>
-        If you are looking for a specific kernel commit,
-        or a commit log message containing a particular string, then searching
-        <a href="https://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git"> Linus' Git tree</a>
-        can be useful.
+        These websites are useful because they in part include attempts
+        by others to summarize changes to the Linux kernel.
     </p>
 
+    <ul>
+        <li>
+            <a href="https://lwn.net/">https://lwn.net/</a>.
+            The weekly kernel page is especially useful, since it summarizes
+            a lot of current and planned changes to the kernel.
+	    There is also a
+	    <a href="https://lwn.net/Kernel/Patches">kernel patch page</a>
+	    where the LWN.net editors attempt to filter some
+	    of the more noteworthy patches.
+            <br>
+            <br>
+        </li>
+    
+        <li>
+            <a href="https://wiki.kernelnewbies.org/LinuxChanges">https://wiki.kernelnewbies.org/LinuxChanges</a>.
+            Summarizes major internal and interface changes for each
+            kernel release (starting sometime in the 2.6.x series).
+            <br>
+            <br>
+        </li>
+    </ul>
 
-<h3>Mailing lists</h3>
-
-    <p>
-        <strong>Linux API</strong>
-    </p>
+<h3>Linux API mailing list</h3>
 
     <p>
         The <a href="linux-api-ml.html">linux-api mailing list</a>
@@ -241,6 +247,39 @@ Maintaining Linux <em>man-pages</em>
         <a href="https://lore.kernel.org/linux-api/">lore.kernel.org</a>.
     </p>
 
+
+<h2>Keeping up&mdash;some other possibilities</h2>
+
+<p>
+   Below are some other ways of trying to discover changes in the
+   kernel and glibc. There's way too much information to track
+   (in particular, it's pretty much impossible to track all of
+   of the mailing lists), but I keep this list as a way
+   of reminding myself of where useful pieces of info could be found.
+</p>
+
+<h3>Looking ahead: <em>linux-next</em></h3>
+
+<p>
+    The <a href="https://git.kernel.org/cgit/linux/kernel/git/next/linux-next.git"><em>linux-next</em> tree</a>
+    is the holding area for patches aimed at the next kernel merge window.
+    It can be useful to track what's going on there,
+    in order to get some idea of upcoming changes to the kernel.
+    (<a href="linux-next.html">Some notes on working with <em>linux-next</em></a>.)
+</p>
+
+<h3>Git</h3>
+
+    <p>
+        If you are looking for a specific kernel commit,
+        or a commit log message containing a particular string, then searching
+        <a href="https://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git"> Linus' Git tree</a>
+        can be useful.
+    </p>
+
+
+<h3>Mailing lists</h3>
+
     <p>
         <strong>Linux Kernel (LKML)</strong>
     </p>
@@ -398,36 +437,6 @@ subscribe linux-net in the message body to majordomo@vger.kernel.org
     </p>
 
 
-<h3>Websites</h3>
-
-    <p>
-        These websites are useful because they in part include attempts
-        by others to summarize changes to the Linux kernel.
-    </p>
-
-    <ul>
-        <li>
-            <a href="https://lwn.net/">https://lwn.net/</a>.
-            The weekly kernel page is especially useful, since it summarizes
-            a lot of current and planned changes to the kernel.
-	    There is also a
-	    <a href="https://lwn.net/Kernel/Patches">kernel patch page</a>
-	    where the LWN.net editors attempt to filter some
-	    of the more noteworthy patches.
-            <br>
-            <br>
-        </li>
-    
-        <li>
-            <a href="https://wiki.kernelnewbies.org/LinuxChanges">https://wiki.kernelnewbies.org/LinuxChanges</a>.
-            Summarizes major internal and interface changes for each
-            kernel release (starting sometime in the 2.6.x series).
-            <br>
-            <br>
-        </li>
-    </ul>
-
-
 <!--
 <h3>Kernel releases</h3>