diff --git a/railties/guides/source/migrations.textile b/railties/guides/source/migrations.textile
index 0eebe742c9..4cb95d9c4d 100644
--- a/railties/guides/source/migrations.textile
+++ b/railties/guides/source/migrations.textile
@@ -622,13 +622,17 @@ A migration creating a table and adding an index might produce output like this
 ==  CreateProducts: migrated (0.0028s) ========================================
 </shell>
 
-Several methods are provided that allow you to control all this:
+Several methods are provided in migrations that allow you to control all this:
 
-* +suppress_messages+ takes a block as an argument and suppresses any output
-* generated by the block.  +say+ takes a message argument and outputs it as is.
-* A second boolean argument can be passed to specify whether to indent or not.
-* +say_with_time+ outputs text along with how long it took to run its block. If
-* the block returns an integer it assumes it is the number of rows affected.
+|_.Method             |_.Purpose|
+|suppress_messages    |takes a block as an argument and suppresses any output
+                       generated by the block.|
+|say                  |Takes a message argument and outputs it as is. A second
+                       boolean argument can be passed to specify whether to
+                       indent or not.|
+|say_with_time        |Outputs text along with how long it took to run its
+                       block. If the block returns an integer it assumes it 
+                       is the number of rows affected.|
 
 For example, this migration