Feedback on tool-description.md

Comments, suggestions and minor changes for the tool description document.