diff --git a/_includes/content/ssh/ssh-add-keys-to-agent.md b/_includes/content/ssh/ssh-add-keys-to-agent.md
index 5e9b82530b..8e923cdcbd 100644
--- a/_includes/content/ssh/ssh-add-keys-to-agent.md
+++ b/_includes/content/ssh/ssh-add-keys-to-agent.md
@@ -38,6 +38,7 @@ passphrases in your keychain.
{% endcapture %}
{{ mac-content-add | markdownify }}
+
@@ -63,6 +64,7 @@ passphrases in your keychain.
{% endcapture %}
{{ win-content-add | markdownify }}
+
@@ -88,5 +90,6 @@ passphrases in your keychain.
{% endcapture %}
{{ linux-content-add | markdownify }}
+
diff --git a/_includes/content/ssh/ssh-copy-key.md b/_includes/content/ssh/ssh-copy-key.md
index fba226ca90..6a12c476ef 100644
--- a/_includes/content/ssh/ssh-copy-key.md
+++ b/_includes/content/ssh/ssh-copy-key.md
@@ -24,6 +24,7 @@ For example: `$ atom ~/.ssh/id_rsa.pub`
{% endcapture %}
{{ mac-content-copy | markdownify }}
+
@@ -45,6 +46,7 @@ For example: `$ notepad ~/.ssh/id_rsa.pub`
{% endcapture %}
{{ win-content-copy | markdownify }}
+
@@ -69,5 +71,6 @@ For example: `$ vi ~/.ssh/id_rsa.pub`
{% endcapture %}
{{ linux-content-copy | markdownify }}
+
diff --git a/_includes/content/ssh/ssh-find-keys.md b/_includes/content/ssh/ssh-find-keys.md
index c6853b26a2..63fece8c02 100644
--- a/_includes/content/ssh/ssh-find-keys.md
+++ b/_includes/content/ssh/ssh-find-keys.md
@@ -40,6 +40,7 @@
{% endcapture %}
{{ mac-content-find | markdownify }}
+
@@ -77,6 +78,7 @@
{% endcapture %}
{{ win-content-find | markdownify }}
+
@@ -114,5 +116,6 @@
{% endcapture %}
{{ linux-content-find | markdownify }}
+
diff --git a/_includes/content/ssh/ssh-gen-keys.md b/_includes/content/ssh/ssh-gen-keys.md
index 106344f749..8f45bcb40f 100644
--- a/_includes/content/ssh/ssh-gen-keys.md
+++ b/_includes/content/ssh/ssh-gen-keys.md
@@ -36,6 +36,7 @@
```
{% endcapture %}
{{ mac-content-gen | markdownify }}
+
@@ -69,6 +70,7 @@
```
{% endcapture %}
{{ win-content-gen | markdownify }}
+
@@ -102,5 +104,6 @@
```
{% endcapture %}
{{ linux-content-gen | markdownify }}
+
diff --git a/test.md b/test.md
index fbe5063026..c4f9e6b695 100644
--- a/test.md
+++ b/test.md
@@ -2,19 +2,22 @@
description: Smoketest page
title: Testing page
hide_from_sitemap: true
+toc_min: 1
---
# Heading 1
Most pages don't actually have a H1 heading. The page title from the metadata is
-automatically inserted.
+automatically inserted. We have included it here to show all heading levels, and
+set front matter as `toc_min: 1` so that it shows in the navigation bar (on-page
+topics).
## Heading 2
-This is the highest heading included in the right navigation bar.
-To include more heading levels, set `toc_min: 1` in the page-s front-matter.
-You can go all the way to 6, but if `toc_min` is geater than `toc_max` then no
-headings will show.
+By default, this is the highest heading included in the right navigation bar. To
+include more heading levels, set `toc_min: 1` in the page's front-matter (as is
+done on this `test.md` page). You can go all the way to 6, but if `toc_min` is
+geater than `toc_max` then no headings will show.
### Heading 3
@@ -251,6 +254,9 @@ You can nest captures within each other to represent more complex logic with Liq
## Bootstrap and CSS tricks
+Here are cool components you can include on Docs pages using
+[Bootstrap](http://getbootstrap.com/) and [CSS](https://www.w3schools.com/css/).
+
### Tabs
Here are some tabs:
@@ -260,12 +266,15 @@ Here are some tabs:
TAB 2 HEADER
-
TAB 1 CONTENT
-
TAB 2 CONTENT
+
TAB 1 CONTENT
+
TAB 2 CONTENT
You need to adjust the `id` and `data-target` values to match your use case.
+The `
`'s are included simply to add visual separation between tabbed content
+and the other topics on the page.
+
If you have Markdown inside the content of the ``, just add `markdown="1"`
as an attribute in the HTML for the `
` and Kramdown will render it.
@@ -279,12 +288,14 @@ as an attribute in the HTML for the `
` and Kramdown will render it.
- list item 1
- list item 2
+
#### Another Markdown header
- list item 3
- list item 4
+
@@ -304,8 +315,8 @@ other tab set to match.
Python
-
Go content here
-
Python content here
+
Go content here
+
Python content here
And some content between the two sets, just for fun...
@@ -315,8 +326,8 @@ And some content between the two sets, just for fun...
Python
-
Go content here
-
Python content here
+
Go content here
+
Python content here
@@ -326,7 +337,6 @@ In a Bootstrap row, your columns need to add up to 12. Here are three cards in
a row, each of which takes up 1/3 (4/12) of the row. You need a couple `
`s
to clear the row before.
-
This will take up 1/3 of the row unless the screen is small,
then it will take up the whole row.
@@ -556,7 +566,7 @@ $ some other command
$ echo "deb https://packages.docker.com/1.12/apt/repo ubuntu-trusty main" | sudo tee /etc/apt/sources.list.d/docker.list
```
-### GO
+### Go
```go
incoming := map[string]interface{}{