Address comments from @alexgibson on PR #1034
 - indent fixes
 - removed redundant ALT text in figures with a caption
 - use more semantastic ordered list rather than line breaks