-
Notifications
You must be signed in to change notification settings - Fork 283
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
DOCS: replace napolean with numpydoc for the API docs. #5910
base: main
Are you sure you want to change the base?
Conversation
Codecov ReportAll modified and coverable lines are covered by tests ✅
Additional details and impacted files@@ Coverage Diff @@
## main #5910 +/- ##
==========================================
+ Coverage 89.75% 89.77% +0.01%
==========================================
Files 90 93 +3
Lines 22951 22995 +44
Branches 5027 5011 -16
==========================================
+ Hits 20600 20643 +43
- Misses 1620 1622 +2
+ Partials 731 730 -1 ☔ View full report in Codecov by Sentry. |
⏱️ Performance Benchmark Report: 38c6a75Performance shifts
Full benchmark results
Generated by GHA run |
* upstream/main: Enhance Cube slicing docs (SciTools#5735) Bump scitools/workflows from 2024.04.0 to 2024.04.1 (SciTools#5914) [pre-commit.ci] pre-commit autoupdate (SciTools#5913) Revert "Updated environment lockfiles (SciTools#5911)" (SciTools#5912) Shapefile user guide typos (SciTools#5759) Updated environment lockfiles (SciTools#5911)
⏱️ Performance Benchmark Report: 46ad6cdPerformance shifts
Full benchmark results
Generated by GHA run |
⏱️ Performance Benchmark Report: a901752Performance shifts
Full benchmark results
Generated by GHA run |
* upstream/main: (42 commits) Mesh saveload fix (SciTools#6004) used tabs for the install info (SciTools#6013) Fix array_equal behaviour for masked arrays (SciTools#4457) Bump scitools/workflows from 2024.06.1 to 2024.06.2 (SciTools#6008) [pre-commit.ci] pre-commit autoupdate (SciTools#6007) Updated environment lockfiles (SciTools#5996) Added more descriptive errors within concatenate (SciTools#6005) Bump scitools/workflows from 2024.06.0 to 2024.06.1 (SciTools#5998) [pre-commit.ci] pre-commit autoupdate (SciTools#5997) Bump scitools/workflows from 2024.05.1 to 2024.06.0 (SciTools#5986) [pre-commit.ci] pre-commit autoupdate (SciTools#5980) Updated environment lockfiles (SciTools#5983) Bump scitools/workflows from 2024.05.0 to 2024.05.1 (SciTools#5984) Make `slices_over` tests go faster (SciTools#5973) Updated environment lockfiles (SciTools#5979) Update lock files with associated fixes (SciTools#5953) List 25 slowest tests (SciTools#5969) used a note to highlight some text (SciTools#5971) Lazy `iris.cube.Cube.rolling_window` (SciTools#5795) Add memory benchmarks (SciTools#5960) ...
🚀 Pull Request
WIP. DO NOT REVIEW OR MERGE
Description
Retires napolean in favour of numpydoc. This is more compatible with the numpy docstrings we now use. It also allows us to use nitpicky to check all cross referencing in our docs.
nitpicky is only used when using
make html-nitpicky
. This allows us to improve the docs without having to deal with all the warnings in one go.This PR will change how the API Docs look, in particular the layout of the parameters bullet points.
Napolean (old)
numpdoc (new)
Consult Iris pull request check list
Add any of the below labels to trigger actions on this PR: