Assorted docs updates

This should resolve #1390, #1399 and #1383.

```
            DOCUMENT
                          ,,
                         ';;
                          ''
            ____          ||
           ;    \         ||
            \,---'-,-,    ||
            /     (  o)   ||
          (o )__,--'-' \  ||
,,,,       ;'uuuuu''   ) ;;
\   \      \ )      ) /\//
 '--'       \'nnnnn' /  \
   \\      //'------'    \
    \\    //  \           \
     \\  //    )           )
      \\//     |           |
       \\     /            |

        ALL THE THINGS!!!!
```