diff --git a/doc/source/contributing.rst b/doc/source/contributing.rst
index 09a79ed8..60a5f727 100644
--- a/doc/source/contributing.rst
+++ b/doc/source/contributing.rst
@@ -1,5 +1,8 @@
 .. include:: ../../CONTRIBUTING.rst
 
+.. NOTE(dhellmann): The title underline style just below relies on the
+   existing format of the file included just above.
+
 Running the Tests
 -----------------
 
diff --git a/doc/source/migration.rst b/doc/source/migration.rst
index f7314082..28b06ddb 100644
--- a/doc/source/migration.rst
+++ b/doc/source/migration.rst
@@ -1,11 +1,14 @@
-Migrating to Storyboard
------------------------
+=========================
+ Migrating to Storyboard
+=========================
+
 If your project is thinking about migrating to Storyboard
 or has recently migrated to Storyboard, the following will
 help you get started.
 
 Planning to Migrate
 -------------------
+
 So you want to migrate...
 
 - Talk to the storyboard team to see if your project is ready i.e.