Skip to content

Google docstrings#19

Merged
mattyowl merged 5 commits into
mainfrom
google-docstrings
May 27, 2026
Merged

Google docstrings#19
mattyowl merged 5 commits into
mainfrom
google-docstrings

Conversation

@mattyowl

Copy link
Copy Markdown
Owner

No description provided.

mattyowl and others added 5 commits May 26, 2026 21:55
Rewrites @type/@param/@rtype/@return tags to Args:/Returns: sections,
@note: Raises ... to Raises: sections, general @note: to Note: sections,
and strips L{...} cross-reference syntax throughout all seven astLib modules.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Add autodoc_mock_imports for PyWCSTools._wcs and PyWCSTools.wcs so that
Sphinx can import astWCS, astImages, and astPlots without requiring the
compiled C extension. Also fix an over-indented RST bullet list in the
addPlotObjects docstring that caused a docutils unexpected-indentation error.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Replace plain function/class name mentions in docstrings with :func:,
:meth:, :class:, and :data: roles so Sphinx generates hyperlinks in the
HTML output. Covers cross-module references (e.g. astImages functions
cited in astPlots) and intra-module references (e.g. fitSEDDict <->
mags2SEDDict <-> makeModelSEDDictList in astSED).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Replace plain module names in the README bullet list with :mod: roles so
the Sphinx-rendered index page links directly to each module's API
reference section. Also adds the missing astStats section to reference.rst.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Replaces bare URLs in parentheses with RST named links so the URL is
hidden in rendered output (docs, GitHub).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@mattyowl mattyowl merged commit d2524ba into main May 27, 2026
2 of 6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant