diff --git a/documentation/content/en/books/handbook/desktop/_index.adoc b/documentation/content/en/books/handbook/desktop/_index.adoc
--- a/documentation/content/en/books/handbook/desktop/_index.adoc
+++ b/documentation/content/en/books/handbook/desktop/_index.adoc
@@ -57,9 +57,9 @@
 
 Prerequisites:
 
-* Readers of this chapter should already understand how to install either the crossref:x11[x11,X Window System] or crossref:wayland[wayland,Wayland] on FreeBSD.
+* Readers of this chapter should already understand how to install either the <<x11>> or <<wayland>>.
 * Readers are instructed throughout this chapter to install official packages.
-Refer to the section on crossref:ports[ports-using,using the ports collection] to build customized packages from ports.
+Refer to <<ports-using>> to build customized packages from ports.
 
 [[desktop-environments]]
 == Desktop Environments