Fixes #632 - fixes incorrectly nested paragraph

- Fixes #632 - fixes incorrectly nested paragraph. The paragraph
element containing the “More info…” link was inside the definition list
when it should be outside of it.
- Also adds some code comments for method parameters in the
info_box_helper methods for use by the yard gem.
Indents are needed for multi-line comments attached to a parameter or return type, otherwise yard puts it in the main method description http://www.rubydoc.info/gems/yard/file/docs/Tags.md#Multi-line_Tags