echemdb / unitpackage

A Python library to interact with a collection of frictionless datapackages
https://echemdb.github.io/unitpackage/
GNU General Public License v3.0
4 stars 3 forks source link

Streamline Website and Documentation Style #9

Open DunklesArchipel opened 2 years ago

DunklesArchipel commented 2 years ago

Thanks. Looks great.

I just had some style suggestions.

I wonder if we should streamline our style of communication (probably we should have a style guide.) Currently, we have a mix of "one can create", "you can create", "we can create", "something can be created". Maybe we should settle for some style and just use it everywhere. (Probably, whatever Python's documentation does?)

Similarly, I wonder if we should replace some of our links with a simpler "→ Learn more" or something like that. Currently, we also tend to write (overexagerating here) somewhat convoluted "if you would like to see more examples of blablabla, you might want to click on this link"

Should I create an issue?

Originally posted by @saraedum in https://github.com/echemdb/echemdb/pull/35#pullrequestreview-971254109