From b61b9d1a70e71d5d14fc66cbfe41024233f34163 Mon Sep 17 00:00:00 2001
From: Michael Currin <michael.currin@gmail.com>
Date: Sun, 3 May 2020 11:32:14 +0200
Subject: [PATCH] feat: Add content

---
 docs/about_mkdocs.md           | 16 +++++++++++++++-
 docs/tutorial/advanced.md      | 13 ++++++++++++-
 docs/tutorial/setup_project.md |  1 -
 3 files changed, 27 insertions(+), 3 deletions(-)

diff --git a/docs/about_mkdocs.md b/docs/about_mkdocs.md
index f1919ab..098e79c 100644
--- a/docs/about_mkdocs.md
+++ b/docs/about_mkdocs.md
@@ -1,13 +1,27 @@
 # About MkDocs
 
 
+## What is MkDocs?
+
+MkDocs is a Python tool generates a static site based on content written in *markdown*.
+
+If you are new to markdown, see the [Getting Started](https://www.markdownguide.org/getting-started/) page on the Markdown Guide website.
+
+**Links:**
+
+- [mkdocs.org](https://www.mkdocs.org) homepage
+- [mkdocs/mkdocs](https://github.com/mkdocs/mkdocs) on Github
+    > "Project documentation with Markdown."
+- [MkDocs Wiki](https://github.com/mkdocs/mkdocs/wiki) on Github, covering themes, plugins, recipes and more.
+
+
 ## Reasons to use MkDocs
 
 - Create an elegant, modern docs site for your project.
 - Create a static site and serve from Github Pages easily.
 - Low-code solution
     - No need to write HTML or learn templating syntax needed
-    - Use your existing markdown files as content
+    - Use your existing markdown files as content.
     - Configure with a simple YAML file.
 - Customizable.
     - Add custom HTML if you want.
diff --git a/docs/tutorial/advanced.md b/docs/tutorial/advanced.md
index 04f69f0..9bf55af 100644
--- a/docs/tutorial/advanced.md
+++ b/docs/tutorial/advanced.md
@@ -1,4 +1,5 @@
-# Advanced configuration
+# Advanced
+> Beyond the basic configuration and content
 
 Once you've got the [Setup Project](setup_project.md) section, you can customize further using this guide. Or skip this and go to [Usage](usage.md).
 
@@ -50,3 +51,13 @@ You can also structure your project to have the setup above nested inside a `doc
 
 
 An example of this is the [Poetry](https://github.com/python-poetry/poetry/tree/master/docs) repo. That  project is also how I got into MkDocs in the first place.
+
+## Embedding
+
+To embed a gist, just copy and paste the embed script URL which is provided on a gist.
+
+e.g.
+
+```html
+<script src="https://gist.github.com/MichaelCurrin/57caae30bd7b0991098e9804a9494c23.js"></script>
+```
diff --git a/docs/tutorial/setup_project.md b/docs/tutorial/setup_project.md
index 926971b..1e3fd89 100644
--- a/docs/tutorial/setup_project.md
+++ b/docs/tutorial/setup_project.md
@@ -10,7 +10,6 @@ Use one of the approaches below:
 
 - Create a quickstart project with the `new` command covered in [Create a starter site](#create-a-starter-site).
 - Follow the extended guide to create a [Setup up docs site](#setup-a-docs-site) by hand.
-- Click *Use this Template* button on the Github repo to get your own copy.
 
 
 ### Basic structure