split out large docs pages: Plotting, Reading and Writing Files

[dhruvak001]

• Closes split out large docs pages: Plotting, Reading and Writing Files #10484
• Tests added
• User visible changes (including notable bug fixes) are documented in whats-new.rst
• New functions/methods are listed in api.rst

Changes:

Reading and Writing Files (io.rst) split into:
io-netcdf-hdf.rst - netCDF and HDF5 formats
io-zarr.rst - Zarr format
io-other-formats.rst - All other formats (pickle, CSV, GRIB, etc.)

Plotting (plotting.rst) split into:
plotting-lines.rst - 1D/Line plots
plotting-2d.rst - 2D plots (pcolormesh, contour, imshow)
plotting-faceting.rst - Faceting and subplots
plotting-scatter-quiver.rst - Scatter, Quiver, and Streamplot

Both original pages now serve as navigation hubs with toctree structures

[dhruvak001]

@dcherian The split looks to be good but has an error related to 3D plotting. I am not sure about the error, can you please once check and let me know, what needs to be fixed?

[scottyhq]

Looks good thanks @dhruvak001 ! I did a bit of cleanup and also created a dedicated plotting-maps.rst. preview: https://xray--10526.org.readthedocs.build/en/10526/user-guide/plotting.html

I'm thinking the "Complex Numbers" section under I/O is a bit odd. It could be broken out as subsections in computation and under NetCDF. Thoughts @dcherian?

[scottyhq]

Thanks for keeping at it @dhruvak001 . Almost ready to merge. Note that if you want to avoid these automatic pre-commit bot commits you can install pre-commit in your local environment https://docs.xarray.dev/en/stable/contribute/contributing.html#install-pre-commit-hooks

[dhruvak001]

@scottyhq Almost done with the changes suggested.

Note that if you want to avoid these automatic pre-commit bot commits you can install pre-commit in your local environment https://docs.xarray.dev/en/stable/contribute/contributing.html#install-pre-commit-hooks

I had loaded this locally but sometimes forget to check the pre-commit before pushing. 😅

[dcherian]

sometimes forget to check the pre-commit before pushing

If you run pre-commit install it will run the hooks on every commit.

---

I think we should reduce the amount of hierarchy in the left sidebar here. For example "I/O" could be renamed to Reading and Writing Files, and "netCDF" etc. could be at the top-level of the section.

"Visualization" could be renamed to "Plotting" and everything under that subheading could be moved up.

---

I'm thinking the "Complex Numbers" section under I/O is a bit odd. It could be broken out as subsections in computation and under NetCDF.

Yeah "Complex Numbers" is an oddball and could be moved to netCDF. We could also call it "Complex Data Types" and talk about complex numbers and maybe "pandas intervals" in the future.

[dhruvak001]

@dcherian I have made the changess according to review and comment.

If you run pre-commit install it will run the hooks on every commit.

It automatically run before commit sometimes and sometimes not, i am not sure, although i usually run precommit before pushing codes.