Merge pull request #18214 from github/feat/add-contributor-frontmatter

Add support for new contributor frontmatter object

Author: sarahs

content/README.md

@@ -25,6 +25,7 @@ See the [contributing docs](/CONTRIBUTING.md) for general information about work
   - [`includeGuides`](#includeGuides)
   - [`type`](#type)
   - [`topics`](#topics)
+  - [`contributor`](#contributor)
   - [Escaping single quotes](#escaping-single-quotes)
 - [Autogenerated mini TOCs](#autogenerated-mini-tocs)
 - [Versioning](#versioning)
@@ -231,6 +232,18 @@ includeGuides:
 - Type: `String`
 - Optional.
 
+### `contributor`
+- Purpose: Indicate an article is contributed and maintained by a third-party organization, typically a GitHub Technology Partner.
+- Type: `Object`. Properties are `name` and `URL`.
+- Optional.
+
+Example:
+
+```yml
+contributor:
+  name: ACME, inc.
+  URL: https://acme.example.com/
+```
 
 ### Escaping single quotes
 

data/ui.yml

@@ -158,3 +158,4 @@ product_sublanding:
 learning_track_nav:
   prevGuide: Previous guide
   nextGuide: Next guide
+contributor_callout: This article is contributed and maintained by

includes/article.html

@@ -20,6 +20,12 @@ <h1 class="border-bottom-0">{{ page.title }}</h1>
         </div>
       </div>
 
+      {% if page.contributor %}
+        <div class="contributor-callout border rounded-1 mb-4 p-3 border-blue bg-blue-light f5">
+          <p><span class="mr-2">{% octicon "info" %}</span>{% data ui.contributor_callout %} <a href="{{ page.contributor.URL }}">{{ page.contributor.name }}</a>.</p>
+        </div>
+      {% endif %}
+
       {% if page.intro %}
         <div class="lead-mktg">{{ page.intro }}</div>
       {% endif %}

lib/frontmatter.js

@@ -119,6 +119,14 @@ const schema = {
     defaultPlatform: {
       type: 'string',
       enum: ['mac', 'windows', 'linux']
+    },
+    // Documentation contributed by a third party, such as a GitHub Partner
+    contributor: {
+      type: 'object',
+      properties: {
+        name: { type: 'string' },
+        URL: { type: 'string' }
+      }
     }
   }
 }

stylesheets/overrides.scss

@@ -65,7 +65,7 @@
   color: $text-gray-dark;
 }
 
-.product-callout p {
+.product-callout p, .contributor-callout p {
   margin: 0;
 }