[latex3-commits] [git/LaTeX3-latex3-latex2e] clsguide-cleanup: Add usrguide/clsguide update to LaTeX News (b238454d)

[Joseph Wright]

Repository : https://github.com/latex3/latex2e
On branch  : clsguide-cleanup
Link       : https://github.com/latex3/latex2e/commit/b238454d5a638d3d6812dafdc3e19bd2b990ea7b

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

commit b238454d5a638d3d6812dafdc3e19bd2b990ea7b
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


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

b238454d5a638d3d6812dafdc3e19bd2b990ea7b
 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 453379cf..ad65706f 100644
--- a/base/doc/ltnews37.tex
+++ b/base/doc/ltnews37.tex
@@ -332,7 +332,20 @@ the previous release, but only now documented in a newletter.
 %
 \githubissue{967}
 
-
+\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}