Release notes#
Note
For release notes (sparsely) kept prior to 1.0.0, look at the releases page on GitHub.
1.3.1#
Release date: 30 April 2022
Requires Python 3.7+ and Sphinx 3.0+.
Closed issues:
numpydoc-1.3.tar.gz on pypi is missing requirements/ needed by setup.py #387
What to do about Jinja2 dependency & supporting old sphinx versions #380
RFE: please update for
jinja2
3.x #376Test failures with Sphinx 4.5.0 #373
Merged pull requests:
Update doc requirements #389 (jarrodmillman)
Update manifest #388 (jarrodmillman)
1.3#
Release date: 29 April 2022
Requires Python 3.7+ and Sphinx 3.0+.
Closed issues#
Merged pull requests#
Require sphinx>3 #385 (jarrodmillman)
Update tests + coverage config to rm warnings. #383 (rossbar)
Runtime verification of sphinx and jinja2 versions #381 (rossbar)
DOC: fix broken link to built-in validation checks. #379 (rossbar)
Add pre-commit hook / linter #374 (jarrodmillman)
Remove deprecated numpydoc_edit_link #372 (jarrodmillman)
Cleanup cruft #371 (jarrodmillman)
1.2.1#
Release date: 29 March 2022
Requires Python 3.7+ and Sphinx 1.8+.
Implemented enhancements#
Update year #370 (jarrodmillman)
Fixed bugs#
Use consistent release tags #361 (jarrodmillman)
BUG: 1.2 raises error w.r.t. object has no attribute ‘__name__’ #362
Use isgeneratorfunction to avoid false alarm YD01 validation #368 (jnothman)
Upper bound jinja #369 (jarrodmillman)
Closed issues#
1.2.0#
Release date: 24 January 2022
Requires Python 3.7+ and Sphinx 1.8+.
Implemented enhancements#
Document release process #357 (jarrodmillman)
Use setuptools #349 (jarrodmillman)
ENH: Enable validation during sphinx-build process #302 (rossbar)
Add a note to the docstring standard about long ‘See Also’ entries. #300 (WarrenWeckesser)
ENH: Add configuration option for parameter cross-referencing #295 (rossbar)
Fixed bugs#
How to specify that parameter can equal the string ‘integer’? #341
Fix validation bug when parameter type is set of options. #347 (rossbar)
Correctly validate parameters under the “Other Parameters” section #337 (dcbr)
BUG: fix an incomplete check in
Reader.\_error\_location
#308 (rgommers)BUG: Properly parse See Also when summary on first line. #283 (Carreau)
Closed issues#
Class methods (@classmethod) are not documented using
numpydoc
#340Exclude certain methods from METHODS section #338
Warnings is not allowed in “GL06” check #334
Add version to style guide #333
numpydoc does not render parameters as expected #329
1.1.0: pytest warnings #324
RTD configuration -
latest
#321Rendering of types in latest doc build #318
Anchors for individual sections in numpydoc doc? #317
Development documentation not up-to-date #311
Warning: autosummary: stub file not found #290
Wrong number of Parameter for numpy array. #285
syntax to document default values #284
Failed See Also Parsing. #281
Sphinx emits “WARNING: py:class reference target not found” with numpydoc 1.1.0 #275
1.1.0#
Implemented enhancements#
Fixed bugs#
Closed issues#
Additional notes#
Due to merging of #221, self and cls no longer will appear in method signatures.
1.0.0#
Implemented enhancements#
MAINT,STY: Upgrade to bionic, and change style similar to NumPy #253 (mwtoews)
Adding –validate option __main__ and run new validation #240 (datapythonista)
Add docstring validation script (from pandas) #238 (datapythonista)
DOC: Add description for blank lines after the docstring. #229 (bingyao)
Fixed bugs#
Removed#
Closed issues#
Additional notes#
CSS styling changed from NumpyDoc < 0.8 and Sphinx < 2.0 to more properly make use of definition lists. This can cause issues with rendering that can be fixed via CSS, especially when using
sphinx-rtd-theme
. For more information, see: