[latex3-commits] [git/LaTeX3-latex3-latex2e] develop: Add usrguide/clsguide update to LaTeX News (974fe9d9)

[Joseph Wright]

Repository : https://github.com/latex3/latex2e
On branch  : develop
Link       : https://github.com/latex3/latex2e/commit/974fe9d9a6268c4a710bfbe475b6d2a29ca72a63

>---------------------------------------------------------------

commit 974fe9d9a6268c4a710bfbe475b6d2a29ca72a63
Author: Joseph Wright <joseph.wright at morningstar2.co.uk>
Date:   Fri Jan 13 07:43:28 2023 +0000

    Add usrguide/clsguide update to LaTeX News


>---------------------------------------------------------------

974fe9d9a6268c4a710bfbe475b6d2a29ca72a63
 base/doc/ltnews37.tex | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/base/doc/ltnews37.tex b/base/doc/ltnews37.tex
index d29a70c6..da473763 100644
--- a/base/doc/ltnews37.tex
+++ b/base/doc/ltnews37.tex
@@ -464,7 +464,6 @@ the previous release, but only now documented in a newletter.
 %
 \githubissue{967}
 
-
 \subsection{Ensure that \cs{cs} is defined in \cls{ltxdoc}}
 
 The class \cls{ltxdoc} defined the command \cs{cs} to typeset a
@@ -513,6 +512,20 @@ This will improve \cs{boldsymbol} and \cs{bm} and similar commands.
 %
 \githubissue{1028}
 
+\section{Documentation improvements}
+
+When \LaTeXe{} was released, the team provided documentation for both document
+authors and package/class developers in the two files \texttt{usrguide} and
+\texttt{clsguide}. Over time, the team have augmented these documents as new
+methods have been added to the kernel. However, they retained there structure
+as starting from familiarity with \LaTeX{}~2.09. This meant that for new users,
+there was material which is no longer relevant, and less clarity than desirable
+in what approaches are recommended today.
+
+The two files have now been (parially) re-written, with the versions available
+previously now frozen as \texttt{usrguide-historic} and \texttt{clsguide-historic}.
+More material has been carried forward in the class/package guide than in the
+user guide, but both are worth a re-read by experienced \LaTeX{} users.
 
 \section{Changes to packages in the \pkg{amsmath} category}