docs(zref-clever): fix docs about clever references

jdujava · jdujava · commit cfa67698d9f0 · 2025-05-11T18:25:51.000+02:00
Signed-off-by: Jonas Dujava &lt;jonas.dujava@gmail.com&gt;
diff --git a/chapters/Features.tex b/chapters/Features.tex
@@ -306,13 +306,15 @@ \subsection{References and Links}%
     By default, \package{hyperref} provides frames around links, but they are not that pretty, and the PDF viewer must support them.
     Using just colors can sometimes look better, but I still wasn't satisfied.
 
-    Sometimes it is nice to know the precise location of the reference, especially when printed, where you can't click on them.
-    % Additionally, it is sometimes good to have an idea where the links point, especially when printed, where you can't click on them.
-    Therefore, the page number is (by default) included with \custommacro{\Cref} --- use starred variant \custommacro{\Cref*} to omit it.
+    Sometimes it is nice to know the precise location of the reference, especially when the document is printed and you cannot simply click on them.
+    Therefore, the page number is (by default) included with \custommacro{\Cref}, see \Cref{rem:zref-clever}.
+    Use the starred variant \custommacro{\Cref*} to omit it.
 \end{remark}
-\begin{remark}[Automatic Reference Type Detection]
-    Package \package{cleveref} provides \macro{\Cref} command, which automatically detects the type of reference, and formats it accordingly.
-    This behavior is adapted in \TeXtured{} with the macro of the same name \custommacro{\Cref}.
+\begin{remark}[Automatic Reference Type Detection] \label{rem:zref-clever}
+    Package \package{zref-clever} provides \macro{\zcref} command --- similarly to the older, no longer maintained, \package{cleveref} package --- which automatically detects the type of reference, and formats it accordingly.
+    This behavior is adapted in \TeXtured{} with the macro \custommacro{\Cref}, which wraps the link in nice box, and also shows a corresponding page number of the target.
+
+    If you want the link to show the reference title, use \custommacro{\Nref} --- or the starred variant \custommacro{\Nref*} to omit the page number --- which utilizes \package{zref-titleref}.
 \end{remark}
 
 \subsection{Table of Contents and Outline/Index}%
diff --git a/chapters/Tips.tex b/chapters/Tips.tex
@@ -38,15 +38,13 @@ \subsection{Structure Environments}%
           \end{Todo}
     \item Try to motivate every definition/theorem with \enquote{normal} text, do not let the document degenerate just into a listing of definitions/theorems/proofs/...
     \item Use references to other remarks/definitions/sections to make the document more interconnected, which can help the reader to look at a bigger picture, recollect necessary information to proceed further, or to understand the context better.
-          \begin{Todo}
-              Describe \custommacro{\Cref}, \custommacro{\Nref}.
-          \end{Todo}
-          \begin{Todo}
-              Show using \macro{\autocite{TODO}} in the text \autocite{TODO}.
-              Helps to not forget to add the citation later.
-          \end{Todo}
 \end{itemize}
 
+\begin{Todo}
+    Show using \macro{\autocite{TODO}} in the text \autocite{TODO}.
+    Helps to not forget to add the citation later.
+\end{Todo}
+
 
 \section{Typography}%
 \label{sec:Typography}
