microsoft / computervision-recipes

Best Practices, code samples, and documentation for Computer Vision.
MIT License
9.53k stars 1.18k forks source link

improve image classification readme #178

Open chenhuims opened 5 years ago

chenhuims commented 5 years ago

Please find a few suggestions for improving the readme file and conda yml file below:

vapaunic commented 5 years ago

I found additionally a couple of small typos and re-words. Please see below:

Why is “required” in "These notebooks contain introductory "required" material." in classification/README.md in quotes. Is this material not required? Might be nice to follow up with a sentence, explaining this.

“While all notebooks can be executed in Windows, we have found the computer vision tools are often faster and more stable on the Linux operating system” – is this true or is it your preference?

We have also found that some browsers do not render Jupyter widgets correctly. If you have issues, try using an alternative browser, such as Chrome. – maybe also add Edge or Chrome.

Reword notebook descriptions in the table to be consistent. Some descriptions use “[this notebook] Demonstrates how to ….” and some use “[you] Use this notebook to ..”.