astropy / astropy/sphinx-astropy

Cut back the default intersphinx mapping

Open
#9 2 comments 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
7
Forks
19
Avg merge
5h 41m
Merged PRs (30d)
1

Description

Actually I'm not sure why we provide the intersphinx mapping in here for so many optional dependencies but missed some others (e.g. why `h5py` but not `pandas`)?

I suggest to only keep python, numpy and astropy here, and the rest can go into `docs/conf.py` for the package repositories. If we keep it however, consider adding more mappings.

Contributor guide

No contributing guide indexed for this repository

Research direction

Inspect the default intersphinx mapping in the repository and compare it with the package repositories' docs/conf.py files. Confirm which mappings should remain for Python, NumPy, and Astropy, then verify that optional-dependency mappings are handled in the package documentation configuration.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.