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

third_party/docfx/templates/devsite/UniversalReference.common.js

@@ -64,6 +64,9 @@ exports.transform = function (model) {
     }
   }
 
+  if (model.summary != null && model.friendlyApiName) {
+    model.summary = common.addIntroSentenceToSummary(model.summary, model.friendlyApiName, model.type, model.name)
+  }
   return model;
 }
 
@@ -102,7 +105,7 @@ function handleItem(vm, gitContribute, gitUrlPattern) {
   vm.sourceurl = common.getViewSourceHref(vm, null, gitUrlPattern);
 
   // set to null incase mustache looks up
-  vm.summary = vm.summary || null;
+  vm.summary = vm.summary != null ? vm.summary : null;
   vm.remarks = vm.remarks || null;
   vm.conceptual = vm.conceptual || null;
   vm.syntax = vm.syntax || null;

third_party/docfx/templates/devsite/UniversalReference.html.primary.js

@@ -25,4 +25,4 @@ exports.getOptions = function (model) {
   return {
     "bookmarks": urefCommon.getBookmarks(model)
   };
-}
+}

third_party/docfx/templates/devsite/UniversalReference.html.primary.tmpl

@@ -1,7 +1,7 @@
 {{!Copyright (c) Microsoft. All rights reserved. Licensed under the MIT license. See LICENSE file in the project root for full license information.}}
 {{!master(layout/_master.tmpl)}}
 
-<h1 class="page-title">{{title}}</h1>
+<h1 class="page-title">{{#friendlyApiName}}{{friendlyApiName}} - {{/friendlyApiName}}{{title}}</h1>
 {{#isNamespace}}
   {{>partials/uref/namespace}}
 {{/isNamespace}}

third_party/docfx/templates/devsite/common.js

@@ -13,6 +13,7 @@ exports.isAbsolutePath = isAbsolutePath;
 exports.isRelativePath = isRelativePath;
 
 exports.getTitleForTypeProperty = getTitleForTypeProperty;
+exports.addIntroSentenceToSummary = addIntroSentenceToSummary;
 
 function getFileNameWithoutExtension(path) {
     if (!path || path[path.length - 1] === '/' || path[path.length - 1] === '\\') return '';
@@ -107,6 +108,30 @@ function getTitleForTypeProperty(type, name, uid) {
     }
 }
 
+/**
+ * Updates summary with an intro sentence containing the friendly API name.
+ *
+ * @param {string} summary The summary for the item.
+ * @param {string} type The type for the item (i.e. class, module).
+ * @param {string} friendlyApiName The friendly API title for the item.
+ * @param {Array} name The names for the item, only the first item is used for forming the sentence.
+ */
+function addIntroSentenceToSummary(summary, friendlyApiName, type, name) {
+    if (summary == null || !type || !name) return summary;
+    if (!titlePrefixForTypeProperty[type]) return summary;
+
+    summaryIntro = "<p>"
+    summaryIntro += "Reference documentation and code samples for the ";
+    summaryIntro += friendlyApiName;
+    summaryIntro += " ";
+    summaryIntro += titlePrefixForTypeProperty[type].toLowerCase();
+    summaryIntro += " ";
+    summaryIntro += name[0].value;
+    summaryIntro += "."
+    summaryIntro += "</p>";
+    return summaryIntro + summary;
+}
+
 var gitUrlPatternItems = {
     'github': {
         // HTTPS form: https://github.com/{org}/{repo}.git