Conversation
for more information, see https://pre-commit.ci
|
Nice. Shall we stick this in the main docs instead? https://docs.xarray.dev/en/stable/user-guide/io.html It strikes me that that page is also missing a nice intro ;) |
Agreed... I can see some good arguments for this material (text and diagram) to go directly into the docs, and then this tutorial page just becomes a really short pointer to the docs page and the subsequent examples. Happy to move accordingly but wanted to keep refining the content while we decide. |
for more information, see https://pre-commit.ci
for more information, see https://pre-commit.ci
|
@TomNicholas @scottyhq @negin513 @betolink Since this was ideated (thanks, Tom!) at our SciPy2024 tutorial planning meeting - any thoughts on where this diagram lives (docs versus tutorial, with a link from the other)? |
for more information, see https://pre-commit.ci
for more information, see https://pre-commit.ci
for more information, see https://pre-commit.ci
|
Can anyone help with the configuration options to get this building? To use the |
I'm hoping #270 (bumping sphinx versions) will just remedy this! I'll try to dig into it a bit more soon |
After some more thought and discussion with others, I'm going to move the diagram and some of this intro content to the docs as suggested by @dcherian. Then I'll revamp this PR to have a shorter intro that links to those pages. |
|
See also (which will need to be merged before this PR): pydata/xarray#9175 |
|
♻️ PR Preview daa22e6 has been successfully destroyed since this PR has been closed.
🤖 By surge-preview |
scottyhq
left a comment
There was a problem hiding this comment.
Thanks for this! I think the content flows better top to bottom and the flowchart in the main Xarray docs is great.
Navigating Xarray backends (
engine="rioxarray") when usingxr.open_dataset()can be confusing. One way to help clarify is by guiding the user through determining if the engine they need exists and is built-in, available from another library, or needs to be created. Here we introduce a flowchart to help guide that process.