diff --git a/en-US/index.adoc b/en-US/index.adoc
index cc33a07..e4ae969 100644
--- a/en-US/index.adoc
+++ b/en-US/index.adoc
@@ -1,18 +1,20 @@
 Fedora Quick Docs
 =================
 
-This repository represents asciidoc documents roughly converted from the top
-50 document-like pages in the Fedora Wiki. We want to move away from
-exposing users to the wild territory of workspace wikis and to a nice,
-topic-oriented format with a PR-based workflow.
+This repository represents
+http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/[asciidoc]
+documents roughly (semi-automatically) converted from the top 50
+document-like pages in the Fedora Wiki. We want to move away from exposing
+users to the wild territory of workspace wikis and to a nice, topic-oriented
+format with a PR-based workflow.
 
 So, this is kind of a seed project. *Your help wanted!*
 
 Please:
 
-1. Pick a document to update
-2. Fork the https://pagure.io/fedora-docs/quick-docs repo
-3. Make your changes to the `.adoc` file you want to improve
-4. Update `_topic_map.yml` to remove `(FIX ME!)`
-5. Submit a pull request with your improvements
+1. Pick a document to update.
+2. Fork the https://pagure.io/fedora-docs/quick-docs repo.
+3. Make your changes to the `.adoc` file you want to improve.
+4. Update `_topic_map.yml` to remove "`(FIX ME!)`"
+5. Submit a pull request with your improvements.
 6. Update the original wiki page with `{{old}}` and a link to the shiny new document