From 2f80c266339b26d5b4ccfe8406389c38b61d9218 Mon Sep 17 00:00:00 2001
From: Alex Pott <alex.a.pott@googlemail.com>
Date: Thu, 10 Mar 2016 14:12:21 +0000
Subject: [PATCH] Issue #2680307 by metzlerd, jhodgdon: Direct people to
 Services and Elements pages on API sites in a clearer way

(cherry picked from commit e0b0ed3fb88d5f519877f3ee3887a84b0c1aea83)
---
 core/core.api.php                         | 3 ++-
 core/lib/Drupal/Core/Render/theme.api.php | 7 +++++--
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/core/core.api.php b/core/core.api.php
index 27bc96d5c0f1..f00ebe3343a9 100644
--- a/core/core.api.php
+++ b/core/core.api.php
@@ -709,7 +709,8 @@
  * top-level core directory). Some Drupal Core modules and contributed modules
  * also define services in modulename.services.yml files. API reference sites
  * (such as https://api.drupal.org) generate lists of all existing services from
- * these files, or you can look through the individual files manually.
+ * these files. Look for the Services link in the API Navigation block.
+ * Alternatively you can look through the individual files manually.
  *
  * A typical service definition in a *.services.yml file looks like this:
  * @code
diff --git a/core/lib/Drupal/Core/Render/theme.api.php b/core/lib/Drupal/Core/Render/theme.api.php
index d9c0fc9a277b..19a7038d7393 100644
--- a/core/lib/Drupal/Core/Render/theme.api.php
+++ b/core/lib/Drupal/Core/Render/theme.api.php
@@ -324,8 +324,11 @@
  *   namespace Element, and generally extend the
  *   \Drupal\Core\Render\Element\FormElement base class.
  * See the @link plugin_api Plugin API topic @endlink for general information
- * on plugins, and look for classes with the RenderElement or FormElement
- * annotation to discover what render elements are available.
+ * on plugins. You can search for classes with the RenderElement or FormElement
+ * annotation to discover what render elements are available. API reference
+ * sites (such as https://api.drupal.org) generate lists of all existing
+ * elements from these classes. Look for the Elements link in the API Navigation
+ * block.
  *
  * Modules can define render elements by defining an element plugin.
  *
-- 
GitLab