diff --git a/core/lib/Drupal/Core/Entity/EntityInterface.php b/core/lib/Drupal/Core/Entity/EntityInterface.php
index a91b6948fa0a6e96257b19c1e5227f1e05802163..6b1a58336d0951cbf1dc7ec19619861ef9666a9e 100644
--- a/core/lib/Drupal/Core/Entity/EntityInterface.php
+++ b/core/lib/Drupal/Core/Entity/EntityInterface.php
@@ -101,14 +101,14 @@ public function label();
    * example:
    * @code
    * links = {
-   *   "canonical" = "/node/{node}",
-   *   "edit-form" = "/node/{node}/edit",
-   *   "version-history" = "/node/{node}/revisions"
+   *   "canonical" = "node.view",
+   *   "edit-form" = "node.page_edit",
+   *   "version-history" = "node.revision_overview"
    * }
    * @endcode
    * or specified in a callback function set like:
    * @code
-   * uri_callback = "contact_category_uri",
+   * uri_callback = "comment_uri",
    * @endcode
    * If the path is not set in the links array, the uri_callback function is
    * used for setting the path. If this does not exist and the link relationship