Skip to content

Docs/contrib#56

Merged
cako merged 8 commits intomainfrom
docs/contrib
Jan 12, 2026
Merged

Docs/contrib#56
cako merged 8 commits intomainfrom
docs/contrib

Conversation

@cako
Copy link
Owner

@cako cako commented Jan 12, 2026

Note

Refactors documentation generation and structure for clarity and reliability.

  • Move/regenerate API docs under docs/api and update flows: Makefile doc/cleandoc targets, and noxfile.py build_api_docs (simplified sphinx-apidoc flags); update index to use API <api/modules>
  • Add Contributing guide (docs/contributing.rst) and link it from the homepage
  • Improve Sphinx config: add reset_curvelets_modules and set via setup() to avoid caching/pickling issues; keep gallery config while deferring reset_modules assignment
  • Tidy generated API pages (e.g., modules.rst title to curvelets, remove explicit UDCTModule autoclass)
  • Adjust curvelets.torch.UDCT property docstrings with :no-index: to reduce API surface

Written by Cursor Bugbot for commit 5b8f4ff. This will update automatically on new commits. Configure here.

@codecov
Copy link

codecov bot commented Jan 12, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 94.26%. Comparing base (dfe7105) to head (5b8f4ff).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main      #56   +/-   ##
=======================================
  Coverage   94.26%   94.26%           
=======================================
  Files          27       27           
  Lines        1848     1848           
=======================================
  Hits         1742     1742           
  Misses        106      106           

☔ 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.

cako added 6 commits January 11, 2026 18:03
Add custom reset function to automatically reset all curvelets
submodules between gallery examples, ensuring clean state.
- Remove intermediate api_reference.rst file
- Update index.rst to reference api/modules.rst directly
- Simplify sphinx-apidoc command in noxfile
- Update Makefile doc target to use cleandoc
- Update cleandoc to remove docs/api instead of docs/source
- Add new api/modules.rst file with proper toctree structure
- Update index.rst to reference api/modules without .rst extension
- Improve GitHub Discussion link text in contributing.rst for clarity
- Add :no-index: directives to UDCT property docstrings to exclude from index
- Add new api/modules.rst file with proper toctree structure
- Update index.rst to reference api/modules without .rst extension
- Improve GitHub Discussion link text in contributing.rst for clarity
- Add :no-index: directives to UDCT property docstrings to exclude from index
@cako cako merged commit 594b611 into main Jan 12, 2026
27 checks passed
@cako cako deleted the docs/contrib branch January 12, 2026 02:50
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