diff --git a/notes/ContributingToCodePage.md b/notes/ContributingToCodePage.md
index 31764cb1c9..cb188f4a08 100644
--- a/notes/ContributingToCodePage.md
+++ b/notes/ContributingToCodePage.md
@@ -1,4 +1,4 @@
-## Contributing to the Code Page
+# Contributing to the Code Page
 
 Hi, thanks for reading the docs!
 
@@ -6,8 +6,8 @@ Secondly, we want to provide a really strong overview of all the libraries in th
 easy for contributors the code page is automatically generated from a series of markdown files in this repo.
 
 ```sh
-$ tree src/content/code
-src/content/code
+$ tree src/code
+src/code
 ├── language-support
 │   ├── c-c
 │   │   └── tools
@@ -45,7 +45,7 @@ npm: "graphql-http"
 
 To run an `graphql-http` hello world server:
 
-```bash
+```sh
 npm install express graphql-http graphql
 ```
 
@@ -56,7 +56,7 @@ var express = require("express")
 var { createHandler } = require("graphql-http/lib/use/express")
 var { buildSchema } = require("graphql")
 
-var schema = buildSchema(`
+var schema = buildSchema(/* GraphQL */`
   type Query {
     hello: String
   }
diff --git a/notes/NewSiteArchitecture.md b/notes/NewSiteArchitecture.md
index 3fd8ea4290..09cfeeb506 100644
--- a/notes/NewSiteArchitecture.md
+++ b/notes/NewSiteArchitecture.md
@@ -164,7 +164,7 @@ This page should serve as a high-level view of what resources are available and
   - Popular blogs
   - Twitter feed
 - Calendar of upcoming meetups or conference talks related to GraphQL (encourage edits by community)
-- Grid of recorded videos about GraphQL (conf talks, etc).
+- Grid of recorded videos about GraphQL (conf talks, etc.).
 
 ## Blog