gists intros (github#27219)

Author: skedwards88

content/rest/gists/comments.md

@@ -1,6 +1,8 @@
 ---
-title: Comments
-intro: ''
+title: Gist comments
+allowTitleToDifferFromFilename: true
+shortTitle: Comments
+intro: 'The Gist comments API lets you view and modify comments on a gist.'
 versions:
   fpt: '*'
   ghes: '*'
@@ -11,6 +13,10 @@ topics:
 miniTocMaxHeadingLevel: 3
 ---
 
+## About the Gist comments API
+
+The Gist comments API lets you view and modify comments on a gist. For more information about gists, see "[Editing and sharing content with gists](/get-started/writing-on-github/editing-and-sharing-content-with-gists)."
+
 ### Custom media types for Gist comments
 
 These are the supported media types for gist comments.

content/rest/gists/gists.md

@@ -11,6 +11,10 @@ topics:
 miniTocMaxHeadingLevel: 3
 ---
 
+## About the Gists API
+
+The Gist API lets you view and modify gists. For more information about gists, see "[Editing and sharing content with gists](/get-started/writing-on-github/editing-and-sharing-content-with-gists)."
+
 ### Authentication
 
 You can read public gists {% ifversion ghae or ghes %}and create them for anonymous users without a token.{% else %} anonymously, but you must be signed into GitHub to create gists.{% endif %} To read or write gists on a user's behalf, you need the gist OAuth scope and a token. For more information, see "[Scopes for OAuth Apps](/developers/apps/scopes-for-oauth-apps)."