Add and update notes about URL generation

Classes/Controller/DocumentController.php

@@ -118,6 +118,7 @@ public function mainAction()
  *
  * * `PAGE_NO` (for value of `tx_dlf[page]`)
  * * `DOUBLE_PAGE` (for value of `tx_dlf[double]`)
+ * * `PAGE_GRID` (for value of `tx_dlf[pagegrid]`)
  *
  * @return string
  */
@@ -155,8 +156,8 @@ protected function getUrlTemplate()
  return $result;
  };
 
- // Generate two URLs that differ only in tx_dlf[page] and tx_dlf[double].
- // We don't know the order of page and double parameters, so use the values for matching.
+ // Generate two URLs that differ in tx_dlf[page], tx_dlf[double] and tx_dlf[highlight].
+ // We don't know the order of these parameters, so use the values for matching.
  $a = $make(2, 1, 0);
  $b = $make(3, 0, 1);
 

Documentation/Developers/ClientSide.rst

@@ -66,6 +66,15 @@ To dynamically show the metadata sections of the current page:
 
 Rootline configuration is considered.
 
+URLs and Slugs
+==============
+
+For dynamic link generation on the client, a URL template is generated in ``DocumentController::getUrlTemplate()``.
+The template contains placeholders for the relevant parameters, which are then replaced by the current values in ``Controller::makePageUrl()``.
+The generated URL does not include a ``cHash``.
+
+This solution is intended to avoid generating all possible URL variants on the backend while still supporting slugs.
+
 Various
 =======