Open JessicaS11 opened 1 month ago
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 ;)
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.
@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)?
Can anyone help with the configuration options to get this building? To use the sphinxcontrib.mermaid
extension, myst-parser
is needed, but as soon as I added that I started getting an ".md extension already registered" error that I can't figure out how to resolve.
Can anyone help with the configuration options to get this building? To use the sphinxcontrib.mermaid extension,
I'm hoping https://github.com/xarray-contrib/xarray-tutorial/pull/270 (bumping sphinx versions) will just remedy this! I'll try to dig into it a bit more soon
I'm hoping https://github.com/xarray-contrib/xarray-tutorial/pull/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): https://github.com/pydata/xarray/pull/9175
🎊 PR Preview 5870819057e307aceee02b0e0ac06fa71061dbc1 has been successfully built and deployed to https://xarray-contrib-xarray-tutorial-preview-pr-266.surge.sh
🕐 Build time: 0.009s
🤖 By surge-preview
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.