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.
I don't think you need to indent the comment here.