From db8fbdd7710e3833939050457f10960deab2bb01 Mon Sep 17 00:00:00 2001
From: Jeff Epler <jepler@unpythonic.net>
Date: Sat, 12 Aug 2017 10:33:19 -0500
Subject: [PATCH] docs: improve markup

---
 docs/examples.txt | 7 +++++--
 docs/index.txt    | 2 --
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/docs/examples.txt b/docs/examples.txt
index bd7da1e..14b4dcf 100644
--- a/docs/examples.txt
+++ b/docs/examples.txt
@@ -4,9 +4,12 @@ Examples
 Selective fillet
 ----------------
 
-.. include:: ../examples/selective_fillet.poc
-    :code: python
+.. literalinclude:: ../examples/selective_fillet.poc
+    :language: python
+    :linenos:
 
 .. image:: ../images/selective_fillet.png
+    :alt: The result of rendering selective_fillet.poc.  All edges entirely above the centerline of the object are filleted.
+    :width: 75%
 
 For more, see the 'examples' directory in the source distribution.
diff --git a/docs/index.txt b/docs/index.txt
index a073023..8678b88 100644
--- a/docs/index.txt
+++ b/docs/index.txt
@@ -23,8 +23,6 @@ there are likely to be compatibility-breaking changes as it develops.
 
 For installation and setup instructions, see README.md.
 
-Contents:
-
 .. toctree::
     :maxdepth: 2