feat(Ruby): add intro sentence to summary with friendly api name

testdata/goldens/ruby/AUTHENTICATION.html

@@ -38,6 +38,7 @@ <h2 id="quickstart">Quickstart</h2>
 client = ::Google::Cloud::Vision::V1::ProductSearch::Client.new
 </pre>
 
+
 <h2 id="credential-lookup">Credential Lookup</h2>
 <p>The google-cloud-vision-v1 library aims to make authentication
 as simple as possible, and provides several mechanisms to configure your system
@@ -66,7 +67,7 @@ <h3 id="environment-variables">Environment Variables</h3>
 containers where writing files is difficult or not encouraged.</p>
 <p>The environment variables that google-cloud-vision-v1
 checks for credentials are configured on the service Credentials class (such as
-{::Google::Cloud::Vision::V1::ProductSearch::Credentials}):</p>
+<span class='object_link'><a href="Google-Cloud-Vision-V1-ProductSearch-Credentials" title="Google::Cloud::Vision::V1::ProductSearch::Credentials (class)">Google::Cloud::Vision::V1::ProductSearch::Credentials</a></span>):</p>
 <ul>
 <li><code>VISION_CREDENTIALS</code> - Path to JSON file, or JSON contents</li>
 <li><code>VISION_KEYFILE</code> - Path to JSON file, or JSON contents</li>
@@ -81,6 +82,7 @@ <h3 id="environment-variables">Environment Variables</h3>
 client = ::Google::Cloud::Vision::V1::ProductSearch::Client.new
 </pre>
 
+
 <h3 id="configuration">Configuration</h3>
 <p>The path to the <strong>Credentials JSON</strong> file can be configured instead of storing
 it in an environment variable. Either on an individual client initialization:</p>
@@ -91,6 +93,7 @@ <h3 id="configuration">Configuration</h3>
 end
 </pre>
 
+
 <p>Or globally for all clients:</p>
 <pre class="prettyprint lang-rb">require "google/cloud/vision/v1"
 
@@ -101,6 +104,7 @@ <h3 id="configuration">Configuration</h3>
 client = ::Google::Cloud::Vision::V1::ProductSearch::Client.new
 </pre>
 
+
 <h3 id="cloud-sdk">Cloud SDK</h3>
 <p>This option allows for an easy way to authenticate during development. If
 credentials are not provided in code or in environment variables, then Cloud SDK
@@ -121,23 +125,19 @@ <h2 id="creating-a-service-account">Creating a Service Account</h2>
 <a href="#google-cloud-platform-environments">Google Cloud Platform environments</a>, you
 need a Google Developers service account.</p>
 <ol>
-<li>Visit the <a href="https://console.cloud.google.com/project">Google Developers Console</a>.</li>
+<li>Visit the <a href="https://console.cloud.google.com/project">Google Cloud Console</a>.</li>
 <li>Create a new project or click on an existing project.</li>
-<li><p>Activate the slide-out navigation tray and select <strong>API Manager</strong>. From
+<li><p>Activate the menu in the upper left and select <strong>APIs &amp; Services</strong>. From
 here, you will enable the APIs that your application requires.</p>
-<p><img src="https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/enable-apis.png" alt="Enable the APIs that your application requires"></p>
 <p><em>Note: You may need to enable billing in order to use these services.</em></p>
 </li>
 <li><p>Select <strong>Credentials</strong> from the side navigation.</p>
-<p>You should see a screen like one of the following.</p>
-<p><img src="https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account.png" alt="Create a new service account"></p>
-<p><img src="https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account-existing-keys.png" alt="Create a new service account With Existing Keys"></p>
-<p>Find the &quot;Add credentials&quot; drop down and select &quot;Service account&quot; to be
-guided through downloading a new JSON key file.</p>
+<p>Find the &quot;Create credentials&quot; drop down near the top of the page, and select
+&quot;Service account&quot; to be guided through downloading a new JSON key file.</p>
 <p>If you want to re-use an existing service account, you can easily generate a
-new key file. Just select the account you wish to re-use, and click &quot;Generate
-new JSON key&quot;:</p>
-<p><img src="https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/reuse-service-account.png" alt="Re-use an existing service account"></p>
+new key file. Just select the account you wish to re-use, click the pencil
+tool on the right side to edit the service account, select the <strong>Keys</strong> tab,
+and then select <strong>Add Key</strong>.</p>
 <p>The key file you download will be used by this library to authenticate API
 requests and should be stored in a secure location.</p>
 </li>

testdata/goldens/ruby/Google-Api-FieldBehavior.html

@@ -8,10 +8,10 @@
     {% verbatim %}
     <div>
       <article data-uid="Google::Api::FieldBehavior">
-<h1 class="page-title">Module Google::Api::FieldBehavior</h1>
+<h1 class="page-title">Cloud Vision V1 API - Module Google::Api::FieldBehavior</h1>
 
 
-  <div class="markdown level0 summary"><p>An indicator of the behavior of a given field (for example, that a field
+  <div class="markdown level0 summary"><p>Reference documentation and code samples for the Cloud Vision V1 API module Google::Api::FieldBehavior.</p><p>An indicator of the behavior of a given field (for example, that a field
 is required in requests, or given as output but ignored as input).
 This <strong>does not</strong> change the behavior in protocol buffers itself; it only
 denotes the behavior and may affect how API tooling handles the field.</p><p>

testdata/goldens/ruby/Google-Api-ResourceDescriptor-History.html

@@ -8,10 +8,10 @@
     {% verbatim %}
     <div>
       <article data-uid="Google::Api::ResourceDescriptor::History">
-<h1 class="page-title">Module Google::Api::ResourceDescriptor::History</h1>
+<h1 class="page-title">Cloud Vision V1 API - Module Google::Api::ResourceDescriptor::History</h1>
 
 
-  <div class="markdown level0 summary"><p>A description of the historical or future-looking state of the
+  <div class="markdown level0 summary"><p>Reference documentation and code samples for the Cloud Vision V1 API module Google::Api::ResourceDescriptor::History.</p><p>A description of the historical or future-looking state of the
 resource pattern.</p>
 </div>
   <h2 id="consts">Constants

testdata/goldens/ruby/Google-Api-ResourceDescriptor-Style.html

@@ -8,10 +8,10 @@
     {% verbatim %}
     <div>
       <article data-uid="Google::Api::ResourceDescriptor::Style">
-<h1 class="page-title">Module Google::Api::ResourceDescriptor::Style</h1>
+<h1 class="page-title">Cloud Vision V1 API - Module Google::Api::ResourceDescriptor::Style</h1>
 
 
-  <div class="markdown level0 summary"><p>A flag representing a specific style that a resource claims to conform to.</p>
+  <div class="markdown level0 summary"><p>Reference documentation and code samples for the Cloud Vision V1 API module Google::Api::ResourceDescriptor::Style.</p><p>A flag representing a specific style that a resource claims to conform to.</p>
 </div>
   <h2 id="consts">Constants
   </h2>

testdata/goldens/ruby/Google-Api-ResourceDescriptor.html

@@ -8,10 +8,10 @@
     {% verbatim %}
     <div>
       <article data-uid="Google::Api::ResourceDescriptor">
-<h1 class="page-title">Class Google::Api::ResourceDescriptor</h1>
+<h1 class="page-title">Cloud Vision V1 API - Class Google::Api::ResourceDescriptor</h1>
 
 
-  <div class="markdown level0 summary"><p>A simple descriptor of a resource type.</p>
+  <div class="markdown level0 summary"><p>Reference documentation and code samples for the Cloud Vision V1 API class Google::Api::ResourceDescriptor.</p><p>A simple descriptor of a resource type.</p>
 
 <p>ResourceDescriptor annotates a resource message (either by means of a
 protobuf annotation or use in the service config), and associates the
@@ -25,11 +25,7 @@ <h1 class="page-title">Class Google::Api::ResourceDescriptor</h1>
   // For Kubernetes resources, the format is {api group}/{kind}.
   option (google.api.resource) = {
     type: &quot;pubsub.googleapis.com/Topic&quot;
-    name_descriptor: {
-      pattern: &quot;projects/{project}/topics/{topic}&quot;
-      parent_type: &quot;cloudresourcemanager.googleapis.com/Project&quot;
-      parent_name_extractor: &quot;projects/{project}&quot;
-    }
+    pattern: &quot;projects/{project}/topics/{topic}&quot;
   };
 }
 </code></pre>
@@ -38,10 +34,7 @@ <h1 class="page-title">Class Google::Api::ResourceDescriptor</h1>
 
 <pre><code>resources:
 - type: &quot;pubsub.googleapis.com/Topic&quot;
-  name_descriptor:
-    - pattern: &quot;projects/{project}/topics/{topic}&quot;
-      parent_type: &quot;cloudresourcemanager.googleapis.com/Project&quot;
-      parent_name_extractor: &quot;projects/{project}&quot;
+  pattern: &quot;projects/{project}/topics/{topic}&quot;
 </code></pre>
 
 <p>Sometimes, resources have multiple patterns, typically because they can
@@ -52,26 +45,10 @@ <h1 class="page-title">Class Google::Api::ResourceDescriptor</h1>
 <pre><code>message LogEntry {
   option (google.api.resource) = {
     type: &quot;logging.googleapis.com/LogEntry&quot;
-    name_descriptor: {
-      pattern: &quot;projects/{project}/logs/{log}&quot;
-      parent_type: &quot;cloudresourcemanager.googleapis.com/Project&quot;
-      parent_name_extractor: &quot;projects/{project}&quot;
-    }
-    name_descriptor: {
-      pattern: &quot;folders/{folder}/logs/{log}&quot;
-      parent_type: &quot;cloudresourcemanager.googleapis.com/Folder&quot;
-      parent_name_extractor: &quot;folders/{folder}&quot;
-    }
-    name_descriptor: {
-      pattern: &quot;organizations/{organization}/logs/{log}&quot;
-      parent_type: &quot;cloudresourcemanager.googleapis.com/Organization&quot;
-      parent_name_extractor: &quot;organizations/{organization}&quot;
-    }
-    name_descriptor: {
-      pattern: &quot;billingAccounts/{billing_account}/logs/{log}&quot;
-      parent_type: &quot;billing.googleapis.com/BillingAccount&quot;
-      parent_name_extractor: &quot;billingAccounts/{billing_account}&quot;
-    }
+    pattern: &quot;projects/{project}/logs/{log}&quot;
+    pattern: &quot;folders/{folder}/logs/{log}&quot;
+    pattern: &quot;organizations/{organization}/logs/{log}&quot;
+    pattern: &quot;billingAccounts/{billing_account}/logs/{log}&quot;
   };
 }
 </code></pre>
@@ -80,50 +57,10 @@ <h1 class="page-title">Class Google::Api::ResourceDescriptor</h1>
 
 <pre><code>resources:
 - type: &#39;logging.googleapis.com/LogEntry&#39;
-  name_descriptor:
-    - pattern: &quot;projects/{project}/logs/{log}&quot;
-      parent_type: &quot;cloudresourcemanager.googleapis.com/Project&quot;
-      parent_name_extractor: &quot;projects/{project}&quot;
-    - pattern: &quot;folders/{folder}/logs/{log}&quot;
-      parent_type: &quot;cloudresourcemanager.googleapis.com/Folder&quot;
-      parent_name_extractor: &quot;folders/{folder}&quot;
-    - pattern: &quot;organizations/{organization}/logs/{log}&quot;
-      parent_type: &quot;cloudresourcemanager.googleapis.com/Organization&quot;
-      parent_name_extractor: &quot;organizations/{organization}&quot;
-    - pattern: &quot;billingAccounts/{billing_account}/logs/{log}&quot;
-      parent_type: &quot;billing.googleapis.com/BillingAccount&quot;
-      parent_name_extractor: &quot;billingAccounts/{billing_account}&quot;
-</code></pre>
-
-<p>For flexible resources, the resource name doesn&#39;t contain parent names, but
-the resource itself has parents for policy evaluation.</p>
-
-<p>Example:</p>
-
-<pre><code>message Shelf {
-  option (google.api.resource) = {
-    type: &quot;library.googleapis.com/Shelf&quot;
-    name_descriptor: {
-      pattern: &quot;shelves/{shelf}&quot;
-      parent_type: &quot;cloudresourcemanager.googleapis.com/Project&quot;
-    }
-    name_descriptor: {
-      pattern: &quot;shelves/{shelf}&quot;
-      parent_type: &quot;cloudresourcemanager.googleapis.com/Folder&quot;
-    }
-  };
-}
-</code></pre>
-
-<p>The ResourceDescriptor Yaml config will look like:</p>
-
-<pre><code>resources:
-- type: &#39;library.googleapis.com/Shelf&#39;
-  name_descriptor:
-    - pattern: &quot;shelves/{shelf}&quot;
-      parent_type: &quot;cloudresourcemanager.googleapis.com/Project&quot;
-    - pattern: &quot;shelves/{shelf}&quot;
-      parent_type: &quot;cloudresourcemanager.googleapis.com/Folder&quot;
+  pattern: &quot;projects/{project}/logs/{log}&quot;
+  pattern: &quot;folders/{folder}/logs/{log}&quot;
+  pattern: &quot;organizations/{organization}/logs/{log}&quot;
+  pattern: &quot;billingAccounts/{billing_account}/logs/{log}&quot;
 </code></pre></div>
   <div class="inheritance">
     <h2>Inherits</h2>
@@ -284,8 +221,8 @@ <h3 id="Google__Api__ResourceDescriptor_pattern_instance_" data-uid="Google::Api
 
 <p>Examples:</p>
 
-<pre><code>- &quot;projects/\{project}/topics/\{topic}&quot;
-- &quot;projects/\{project}/knowledgeBases/\{knowledge_base}&quot;
+<pre><code>- &quot;projects/\\{project}/topics/\\{topic}&quot;
+- &quot;projects/\\{project}/knowledgeBases/\\{knowledge_base}&quot;
 </code></pre>
 
 <p>The components in braces correspond to the IDs for each resource in the
@@ -316,8 +253,8 @@ <h3 id="Google__Api__ResourceDescriptor_pattern__instance_" data-uid="Google::Ap
 
 <p>Examples:</p>
 
-<pre><code>- &quot;projects/\{project}/topics/\{topic}&quot;
-- &quot;projects/\{project}/knowledgeBases/\{knowledge_base}&quot;
+<pre><code>- &quot;projects/\\{project}/topics/\\{topic}&quot;
+- &quot;projects/\\{project}/knowledgeBases/\\{knowledge_base}&quot;
 </code></pre>
 
 <p>The components in braces correspond to the IDs for each resource in the
@@ -344,8 +281,8 @@ <h3 id="Google__Api__ResourceDescriptor_pattern__instance_" data-uid="Google::Ap
 
 <p>Examples:</p>
 
-<pre><code>- &quot;projects/\{project}/topics/\{topic}&quot;
-- &quot;projects/\{project}/knowledgeBases/\{knowledge_base}&quot;
+<pre><code>- &quot;projects/\\{project}/topics/\\{topic}&quot;
+- &quot;projects/\\{project}/knowledgeBases/\\{knowledge_base}&quot;
 </code></pre>
 
 <p>The components in braces correspond to the IDs for each resource in the

testdata/goldens/ruby/Google-Api-ResourceReference.html

@@ -8,10 +8,10 @@
     {% verbatim %}
     <div>
       <article data-uid="Google::Api::ResourceReference">
-<h1 class="page-title">Class Google::Api::ResourceReference</h1>
+<h1 class="page-title">Cloud Vision V1 API - Class Google::Api::ResourceReference</h1>
 
 
-  <div class="markdown level0 summary"><p>Defines a proto annotation that describes a string field that refers to
+  <div class="markdown level0 summary"><p>Reference documentation and code samples for the Cloud Vision V1 API class Google::Api::ResourceReference.</p><p>Defines a proto annotation that describes a string field that refers to
 an API resource.</p>
 </div>
   <div class="inheritance">

testdata/goldens/ruby/Google-Api.html

@@ -8,9 +8,10 @@
     {% verbatim %}
     <div>
       <article data-uid="Google::Api">
-<h1 class="page-title">Module Google::Api</h1>
+<h1 class="page-title">Cloud Vision V1 API - Module Google::Api</h1>
 
 
+  <div class="markdown level0 summary"><p>Reference documentation and code samples for the Cloud Vision V1 API module Google::Api.</p></div>
 </article>
     </div>
     {% endverbatim %}

testdata/goldens/ruby/Google-Cloud-Vision-V1-AddProductToProductSetRequest.html

@@ -8,10 +8,10 @@
     {% verbatim %}
     <div>
       <article data-uid="Google::Cloud::Vision::V1::AddProductToProductSetRequest">
-<h1 class="page-title">Class Google::Cloud::Vision::V1::AddProductToProductSetRequest</h1>
+<h1 class="page-title">Cloud Vision V1 API - Class Google::Cloud::Vision::V1::AddProductToProductSetRequest</h1>
 
 
-  <div class="markdown level0 summary"><p>Request message for the <code>AddProductToProductSet</code> method.</p>
+  <div class="markdown level0 summary"><p>Reference documentation and code samples for the Cloud Vision V1 API class Google::Cloud::Vision::V1::AddProductToProductSetRequest.</p><p>Request message for the <code>AddProductToProductSet</code> method.</p>
 </div>
   <div class="inheritance">
     <h2>Inherits</h2>

testdata/goldens/ruby/Google-Cloud-Vision-V1-AnnotateFileRequest.html

@@ -8,10 +8,10 @@
     {% verbatim %}
     <div>
       <article data-uid="Google::Cloud::Vision::V1::AnnotateFileRequest">
-<h1 class="page-title">Class Google::Cloud::Vision::V1::AnnotateFileRequest</h1>
+<h1 class="page-title">Cloud Vision V1 API - Class Google::Cloud::Vision::V1::AnnotateFileRequest</h1>
 
 
-  <div class="markdown level0 summary"><p>A request to annotate one single file, e.g. a PDF, TIFF or GIF file.</p>
+  <div class="markdown level0 summary"><p>Reference documentation and code samples for the Cloud Vision V1 API class Google::Cloud::Vision::V1::AnnotateFileRequest.</p><p>A request to annotate one single file, e.g. a PDF, TIFF or GIF file.</p>
 </div>
   <div class="inheritance">
     <h2>Inherits</h2>

testdata/goldens/ruby/Google-Cloud-Vision-V1-AnnotateFileResponse.html

@@ -8,10 +8,10 @@
     {% verbatim %}
     <div>
       <article data-uid="Google::Cloud::Vision::V1::AnnotateFileResponse">
-<h1 class="page-title">Class Google::Cloud::Vision::V1::AnnotateFileResponse</h1>
+<h1 class="page-title">Cloud Vision V1 API - Class Google::Cloud::Vision::V1::AnnotateFileResponse</h1>
 
 
-  <div class="markdown level0 summary"><p>Response to a single file annotation request. A file may contain one or more
+  <div class="markdown level0 summary"><p>Reference documentation and code samples for the Cloud Vision V1 API class Google::Cloud::Vision::V1::AnnotateFileResponse.</p><p>Response to a single file annotation request. A file may contain one or more
 images, which individually have their own responses.</p>
 </div>
   <div class="inheritance">

testdata/goldens/ruby/Google-Cloud-Vision-V1-AnnotateImageRequest.html

@@ -8,10 +8,10 @@
     {% verbatim %}
     <div>
       <article data-uid="Google::Cloud::Vision::V1::AnnotateImageRequest">
-<h1 class="page-title">Class Google::Cloud::Vision::V1::AnnotateImageRequest</h1>
+<h1 class="page-title">Cloud Vision V1 API - Class Google::Cloud::Vision::V1::AnnotateImageRequest</h1>
 
 
-  <div class="markdown level0 summary"><p>Request for performing Google Cloud Vision API tasks over a user-provided
+  <div class="markdown level0 summary"><p>Reference documentation and code samples for the Cloud Vision V1 API class Google::Cloud::Vision::V1::AnnotateImageRequest.</p><p>Request for performing Google Cloud Vision API tasks over a user-provided
 image, with user-requested features, and with context information.</p>
 </div>
   <div class="inheritance">

testdata/goldens/ruby/Google-Cloud-Vision-V1-AnnotateImageResponse.html

@@ -8,10 +8,10 @@
     {% verbatim %}
     <div>
       <article data-uid="Google::Cloud::Vision::V1::AnnotateImageResponse">
-<h1 class="page-title">Class Google::Cloud::Vision::V1::AnnotateImageResponse</h1>
+<h1 class="page-title">Cloud Vision V1 API - Class Google::Cloud::Vision::V1::AnnotateImageResponse</h1>
 
 
-  <div class="markdown level0 summary"><p>Response to an image annotation request.</p>
+  <div class="markdown level0 summary"><p>Reference documentation and code samples for the Cloud Vision V1 API class Google::Cloud::Vision::V1::AnnotateImageResponse.</p><p>Response to an image annotation request.</p>
 </div>
   <div class="inheritance">
     <h2>Inherits</h2>

testdata/goldens/ruby/Google-Cloud-Vision-V1-AsyncAnnotateFileRequest.html

@@ -8,10 +8,10 @@
     {% verbatim %}
     <div>
       <article data-uid="Google::Cloud::Vision::V1::AsyncAnnotateFileRequest">
-<h1 class="page-title">Class Google::Cloud::Vision::V1::AsyncAnnotateFileRequest</h1>
+<h1 class="page-title">Cloud Vision V1 API - Class Google::Cloud::Vision::V1::AsyncAnnotateFileRequest</h1>
 
 
-  <div class="markdown level0 summary"><p>An offline file annotation request.</p>
+  <div class="markdown level0 summary"><p>Reference documentation and code samples for the Cloud Vision V1 API class Google::Cloud::Vision::V1::AsyncAnnotateFileRequest.</p><p>An offline file annotation request.</p>
 </div>
   <div class="inheritance">
     <h2>Inherits</h2>

testdata/goldens/ruby/Google-Cloud-Vision-V1-AsyncAnnotateFileResponse.html

@@ -8,10 +8,10 @@
     {% verbatim %}
     <div>
       <article data-uid="Google::Cloud::Vision::V1::AsyncAnnotateFileResponse">
-<h1 class="page-title">Class Google::Cloud::Vision::V1::AsyncAnnotateFileResponse</h1>
+<h1 class="page-title">Cloud Vision V1 API - Class Google::Cloud::Vision::V1::AsyncAnnotateFileResponse</h1>
 
 
-  <div class="markdown level0 summary"><p>The response for a single offline file annotation request.</p>
+  <div class="markdown level0 summary"><p>Reference documentation and code samples for the Cloud Vision V1 API class Google::Cloud::Vision::V1::AsyncAnnotateFileResponse.</p><p>The response for a single offline file annotation request.</p>
 </div>
   <div class="inheritance">
     <h2>Inherits</h2>