Create documentation and host at readthedocs.io

[DakotaHester]

Documentation created using sphinx and hosted at pcxarray.readthedocs.io. No tests here, but have verified documentation is well-formatted and up-to-date.

[Copilot]

Pull Request Overview

This PR adds comprehensive Sphinx-based documentation for pcxarray and configures hosting on ReadTheDocs.

• Introduces Sphinx configuration files, requirements, RST modules, and Makefiles for building docs.
• Updates code docstrings and type hints for consistency and completeness.
• Adds development dependencies to pyproject.toml and updates examples and README badges.

Reviewed Changes

Copilot reviewed 26 out of 33 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
src/pcxarray/utils.py	Expanded crs type hint, added default value and updated docstring formatting.
src/pcxarray/query.py	Reformatted docstrings, added get_pc_collections function with docs.
src/pcxarray/processing.py	Introduced Literal types for merge methods and cleaned up docstring punctuation.
src/pcxarray/io.py	Reflowed docstrings and standardized default argument formatting.
src/pcxarray/cache.py	Reformatted docstrings for consistency.
pyproject.toml	Added Sphinx and related packages to the dev dependencies.
docs/	Added Sphinx conf, RST files, requirements, and build scripts.
examples/*.ipynb	Added markdown title cells and bumped notebook metadata versions.
README.md	Updated documentation links, badges, and example workflow badge.
.readthedocs.yml	Configured ReadTheDocs build settings.

Comments suppressed due to low confidence (1)

src/pcxarray/query.py:176

• New public function get_pc_collections lacks any corresponding tests. Adding unit tests will ensure correct behavior when listing and filtering STAC collections.

def get_pc_collections(reduced: bool = True, crs: Union[CRS, str, int] = 4326) -> gpd.GeoDataFrame:

[Copilot]

In a Windows batch file, "echo.installed" prints ".installed" rather than the intended message. Add a space after echo (e.g., echo installed, ...) for each echo line.

Suggested change

	echo.
	echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
	echo.installed, then set the SPHINXBUILD environment variable to point
	echo.to the full path of the 'sphinx-build' executable. Alternatively you
	echo.may add the Sphinx directory to PATH.
	echo.
	echo.If you don't have Sphinx installed, grab it from
	echo.https://www.sphinx-doc.org/
	echo.
	echo The 'sphinx-build' command was not found. Make sure you have Sphinx
	echo installed, then set the SPHINXBUILD environment variable to point
	echo to the full path of the 'sphinx-build' executable. Alternatively you
	echo may add the Sphinx directory to PATH.
	echo.
	echo If you don't have Sphinx installed, grab it from
	echo https://www.sphinx-doc.org/

[DakotaHester]

Not committing as make.bat was generated by sphinx, may be something to look into in the future if building on Windows becomes necessary.