Experimental

[henrydingliu]

Summary of Changes

Adds custom sphinx.ext.autosummary templates under docs/_templates/autosummary/: class.rst, class_inherited.rst, function.rst.
API class pages now list methods and properties inline instead of a summary table that links to a separate page per method.
Fixes the :template: names in docs/library/api.md to drop .rst (:template: class.rst → :template: class).
Sets numpydoc_show_class_members = False and templates_path = ['_templates'] in docs/_config.yml (and the generated docs/conf.py).
Guards docs/_ext/linkcode.py against property objects so inline members don't crash the build.
Deletes the 36 .rst stub files under docs/library/generated/.
Adds docs/library/generated/ to .gitignore, mirroring the existing docs/modules/generated/ entry one line above.
These files are emitted by sphinx.ext.autosummary on every docs build (autosummary_generate = True in docs/conf.py, driven by the eight :toctree: generated/ directives in docs/library/api.md), so committing them is redundant and the committed copies drift out of sync with what Sphinx actually produces.
Docs-only; no runtime, config, or public API changes. Rendered HTML site is unchanged — the stubs are regenerated automatically on jb build ..

Three issues fixed along the way:

:template: class.rst never worked. Sphinx appends .rst, so it looked for autosummary/class.rst.rst and fell back to the base template. Names now omit the extension.
numpydoc duplicate table. numpydoc_show_class_members = False stops numpydoc emitting its own members table next to the inline members.
linkcode_resolve crash. Inline members pass property objects to the resolver, where inspect.getsourcefile(property) raises TypeError and aborts jb build. Fixed by unwrapping properties to fget and guarding getsourcefile / getsourcelines.

Related GitHub Issue(s)

closes #887
closes #846
closes #847
partially addresses #888

Additional Context for Reviewers

• conf.py is regenerated from _config.yml by Jupyter Book; both updated to stay in sync.

• jb build . succeeds (warnings all pre-existing). HTML spot checks:

  Page | Inline methods | Inline properties | numpydoc table -- | -- | -- | -- Development (class) | 3 | 0 | none Triangle (class_inherited) | 64 | 24 | none load_sample (function) | function block | – | –

• I passed tests locally for both code (uv run pytest) and documentation changes (uv run jb build docs --builder=custom --custom-builder=doctest)

---

Note

Low Risk
Changes are documentation and docstring formatting only; no runtime behavior or public API semantics are altered.

Overview
This PR reworks Sphinx autosummary so API class pages list members inline instead of linking to per-method stub pages. It adds docs/_templates/autosummary/ templates (class, class_inherited, function), fixes :template: values in docs/library/api.md (drop .rst so Sphinx does not look for class.rst.rst), and sets numpydoc_show_class_members = False plus templates_path in docs/_config.yml / docs/conf.py to avoid duplicate member tables.

Build reliability: docs/_ext/linkcode.py unwraps property objects to fget and guards getsourcefile / getsourcelines so inline members do not abort the docs build. Generated stubs under docs/library/generated/ are removed from the repo and docs/library/generated/ is added to .gitignore (regenerated on each build).

Smaller doc edits: user guide cards swap glue figures for static images; one MackChainladder example moves from panels to a grid card; a bibliography URL is updated. chainladder changes are docstring-only (formatting / RST escaping in pandas.py, incremental.py, capecod.py).

^{Reviewed by Cursor Bugbot for commit 0b26dd3. Bugbot is set up for automated code reviews on this repo. Configure here.}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 87.11%. Comparing base (449b5c1) to head (0b26dd3).
⚠️ Report is 3 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #893      +/-   ##
==========================================
+ Coverage   87.04%   87.11%   +0.07%     
==========================================
  Files          86       87       +1     
  Lines        4986     5154     +168     
  Branches      646      696      +50     
==========================================
+ Hits         4340     4490     +150     
- Misses        456      465       +9     
- Partials      190      199       +9     

Flag	Coverage Δ
unittests	87.11% <ø> (+0.07%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.