larray-project / larray

N-dimensional labelled arrays in Python
https://larray.readthedocs.io/
GNU General Public License v3.0
8 stars 6 forks source link

Tutorial - Getting Started: do no use axes objects defined in a previous section #1099

Open gdementen opened 4 months ago

gdementen commented 4 months ago

When looking at a subsection in isolation (e.g. Aggregation, if you are only interested in that), it is very confusing because the tutorial uses axes names without quotes and then users think it will work like that for their code too, but they do not see (or even if they see it, some do not understand the importance of this) that we defined variables for those axes.

We should probably use quotes for axes names all the way in the getting started, and show and explain the difference in a later section.