envmodules · xdelaruelle · Aug 31, 2026 · May 15, 2026 · Aug 30, 2026 · Aug 30, 2026
diff --git a/.hunspell.en.dic b/.hunspell.en.dic
@@ -1605,3 +1605,15 @@ TOOL2
 sphinxext
 opengraph
 PNG
+HPSFCon
+pu
+xargs
+jq
+PyPI
+gui
+spack
+mpivars
+cuda
+lindex
+defineModStartNbProc
+isIcase
diff --git a/NEWS.rst b/NEWS.rst
@@ -248,6 +248,9 @@ Modules 5.7.0 (not yet released)
   :ref:`CONTRIBUTING`: AI agents must never add their own ``Signed-off-by:``
   trailer and their involvement must be disclosed with an ``Assisted-by:``
   trailer.
+* Doc: add the :ref:`user-guide` document that explains a selection of
+  useful but lesser known features through practical examples and common
+  use cases.
 
 
 .. _5.6 release notes:

diff --git a/doc/source/index.rst b/doc/source/index.rst
@@ -184,6 +184,7 @@ or (at your option) any later version (`GPL-2.0-or-later`).
       INSTALL-win
       MIGRATING
       NEWS
+      user-guide
       FAQ
       changes
       other-implementations

diff --git a/doc/source/latex_index.rst b/doc/source/latex_index.rst
@@ -18,4 +18,5 @@ Introduction
 .. include:: envml.rst
 .. include:: MIGRATING.rst
 .. include:: NEWS.rst
+.. include:: user-guide.rst
 .. include:: changes.rst
diff --git a/doc/source/modulefile.rst b/doc/source/modulefile.rst
@@ -2100,6 +2100,8 @@ or terse reporting of these sub-commands: :mconfig:`avail_output`,
 :mconfig:`list_terse_output`, :mconfig:`spider_output`,
 :mconfig:`spider_terse_output`.
 
+.. _advanced_module_version_specifiers:
+
 Advanced module version specifiers
 ----------------------------------