addressing @chris comments
Improved docs formatting