diff --git a/content/README.md b/content/README.md
index 901427d4be71..f70350d0d611 100644
--- a/content/README.md
+++ b/content/README.md
@@ -1,5 +1,5 @@
 # Content <!-- omit in toc -->
-
+:octocat:
 The `/content` directory is where all the site's (English) Markdown content lives!
 
 See the [markup reference guide](/contributing/content-markup-reference.md) for more information about supported Markdown features.
diff --git a/lib/rest/README.md b/lib/rest/README.md
index d2d1e7acd45c..b282bf737e50 100644
--- a/lib/rest/README.md
+++ b/lib/rest/README.md
@@ -13,13 +13,13 @@
 
 Generated by `script/rest/update-files.js`:
 
-* `lib/rest/static/dereferenced` - dereferenced OpenAPI schema file for each version of GitHub
-* `lib/rest/static/decorated` - files generated from the dereferenced OpenAPI schema with the Markdown descriptions rendered in HTML
+* `lib/rest/static/dereferenced` - dereferenced OpenAPI schema file for each version of GitHub.
+* `lib/rest/static/decorated` - files generated from the dereferenced OpenAPI schema with the Markdown descriptions rendered in HTML.
 
 ## Rendering docs
 
 When the server starts, `middleware/contextualizers/rest.js` accesses the data exported from the static decorated JSON files, fetches the data for the current version and requested path, and adds it to the `context` object. The added property is:
 
-* `req.context.currentRestOperations` - all operations with a category matching the current path
+* `req.context.currentRestOperations` - all operations with a category matching the current path.
 
 Markdown files in `content/rest/reference` use Liquid to loop over these context properties. The Liquid calls HTML files in the `includes` directory to do most of the rendering. Writers can add content to the Markdown files alongside the Liquid.
diff --git a/lib/rest/static/decorated/api.github.com.json b/lib/rest/static/decorated/api.github.com.json
index f5234c81ccac..70a96716d37e 100644
--- a/lib/rest/static/decorated/api.github.com.json
+++ b/lib/rest/static/decorated/api.github.com.json
@@ -6,7 +6,7 @@
     "parameters": [],
     "x-codeSamples": [
       {
-        "lang": "Shell",
+        "lang": "Shells",
         "source": "curl \\\n  -H \"Accept: application/vnd.github.v3+json\" \\\n  https://api.github.com/",
         "html": "<pre><code class=\"hljs language-shell\">curl \\\n  -H \"Accept: application/vnd.github.v3+json\" \\\n  https://api.github.com/</code></pre>"
       },