Suggestions for Bob documentation
The guide is awesome! Here are my 2 cents:
- In the installation, it would be less clutered if you used a conda environment to specify the installation instructions. That allows you to "override" the channels on the yaml file
- At the installation guide, instead of "...in our channel is compatible with the defaults channel." it should read "... are compatible..."
- In "Multi-dimensional arrays", we should not say we undid something, just that Blitz++ arrays are dynamically bound to NumPy arrays and it should be mostly a transparent use.
- Databases section: "Most of the databases are stored in an SQLite file, whereas the smallest ones can be stored as filelists." - advise to remove this and point to our new guide, which explains these concepts in details