clarify info about canonical URL [skip ci]

diff --git a/docs/modules/ROOT/pages/templates.adoc b/docs/modules/ROOT/pages/templates.adoc
index 652fdda..f74a28e 100644 (file)
--- a/docs/modules/ROOT/pages/templates.adoc
+++ b/docs/modules/ROOT/pages/templates.adoc
@@ -101,8 +101,9 @@ It's often used as the base URL to generate relative URLs from this page.
 
 | page.canonicalUrl
 | The canonical URL for the current page.
-If there are older versions of the page, the canonical URL is the URL of the latest version.
-//If this is an aspect page, the canonical URL is the URL of the primary (non-aspect) page.
+The canonicalUrl is only set if site.url is set.
+If there are multiple versions of the component, the canonical URL is the qualified URL of the most recent version of the page (excluding any prerelease versions).
+If there's only a single version of the component, the canonical URL is the qualified URL of the current page.
 
 | page.editUrl
 | The URL to edit the current page, typically on GitHub.