Docs: Add detail on chunk manifest / chunk manifest shape

[tylanderson]

What I did

Adding more detail on chunk manifests construction, and particularly on chunk grid shape, what it means and when to use it directly vs when it will be generated.

This was something that would have been helpful to have when creating the examples in #953

Acceptance criteria:

• New functionality has documentation

[maxrjones]

Thanks @tylanderson! I think it'd be worth making these code blocks execute when the docs are built, to catch any errors. I've made a few suggestions to enable this. It looks great overall!

[maxrjones]

@tylanderson I think you may have run into a GitHub bug in the code suggestion applications - it looks like the commit just removed the block quotes: a1e1871 (this PR)

[tylanderson]

@tylanderson I think you may have run into a GitHub bug in the code suggestion applications - it looks like the commit just removed the block quotes: a1e1871 (this PR)

Yeah I noticed that, not sure why the batch suggestions dropped them, but should be fixed now

[maxrjones]

@tylanderson I think you may have run into a GitHub bug in the code suggestion applications - it looks like the commit just removed the block quotes: a1e1871 (this PR)

Yeah I noticed that, not sure why the batch suggestions dropped them, but should be fixed now

thanks

It looks like the execution flagged some errors in the examples, where ChunkManifest is not part of the top-level API: https://virtualizarr--961.org.readthedocs.build/en/961/data_structures.html#from-a-dictionary. This is intentional, because the developer API has less stability guarantees - https://virtualizarr--961.org.readthedocs.build/en/961/api/developer.html#virtualizarr.manifests.ChunkManifest.