Extending the glossary

[harshitha1201]

Added align, broadcast, merge, concatenate and combine to terminology.
-> Closes #3355

[headtr1ck]

That is an important addition, the different words and their meaning are always confusing for beginners.

Maybe we could add some very simple examples to demonstrate the effects (1D or 2D arrays).

In general I think you could find better words for "combine", basically every definition uses it.

[headtr1ck]

Actually on top of examples maybe some simple text depictions could be useful?
Something like this for aligning:
Values: [ A A A ] + [ B B ] -> [ A B A B A ]
Index:. [ 1 3 5 ] + [ 2 4 ] -> [ 1 2 3 4 5 ]

But just throwing ideas around

Edit: that's actually not what aligning does, haha. But you get the idea.

[harshitha1201]

@headtr1ck I have done the changes required, please review

[headtr1ck]

Looking better and better. I still have several remarks.

Also, the indentation of the compiled docpage looks wrong (see https://xray--7732.org.readthedocs.build/en/7732/user-guide/terminology.html)
After a code block the following text is no longer indented. I have no idea how this exactly works though...

[TomNicholas]

This looks great, but none of the new definitions are visible in the rendered docs page. I think this is just an indentation problem.

[TomNicholas]

Great PR! Some things left to clarify.

[headtr1ck]

Any reason why you removed the examples?
I didn't follow the review process if this was requested by someone.

[harshitha1201]

Any reason why you removed the examples? I didn't follow the review process if this was requested by someone.

I was unable to build the examples while doing make html, but now I'm able to. I'll add them again.

[TomNicholas]

Lazy evaluation is provided alternately by dask or by hidden xarray internals, depending on whether dask is installed. I'm wondering whether it's worth mentioning that here or not. @headtr1ck what do you think? I've added it to #7991 so we could link to that page?

[TomNicholas]

I think we can leave this clarification for later.

[TomNicholas]

Great work on this!

General comment 1: The definitions are clearest when they start with a single short sentence succinctly describing the term. Then afterwards you can write a paragraph explaining the context or why that's useful. Look at the entries for DataArray etc. to see what I mean.

General comment 2: We could be adding links to other relevant sections of the documentation. For example the entry on indexing should link to the docs page on indexing.

[TomNicholas]

Thanks @harshitha1201 ! This is a great addition!

[dcherian]

Thanks @harshitha1201