Documentation Improvement Suggestion

thanks @ofek, this is very good feedback. We will include it in our docs.