Some documentation fixes

Tried to beautify the inline documentation and fix some errors. No functional changes
I'm not sure why the extra indent has been removed from this example. If this is only by accident, could you put it back?