Thanks to visit codestin.com
Credit goes to github.com

Skip to content

doc_AxesBase_bug #11442

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

Merged
merged 1 commit into from
Jun 21, 2018
Merged

doc_AxesBase_bug #11442

merged 1 commit into from
Jun 21, 2018

Conversation

fredrik-1
Copy link
Contributor

@fredrik-1 fredrik-1 commented Jun 15, 2018

I found out why the axes init function didn't get rendered in the documentation, #10270. The substitution resulted in a blank docstring.

The init docstring is there.
https://10426-1385122-gh.circle-artifacts.com/0/home/circleci/project/doc/build/html/api/axes_api.html

edit: the use of the decorator is just a proof of concept. The whole docstring should probably be changed to use docstring.dedent_interpd with %(Axes)s instead and be written as a numpydoc docstring.

PR Checklist

  • Has Pytest style unit tests
  • Code is PEP 8 compliant
  • New features are documented, with examples if plot related
  • Documentation is sphinx and numpydoc compliant
  • Added an entry to doc/users/next_whats_new/ if major new feature (follow instructions in README.rst there)
  • Documented in doc/api/api_changes.rst if API changed in a backward-incompatible way

@jklymak
Copy link
Member

jklymak commented Jun 21, 2018

What’s the status of this, is it just proof of concept or did you want this reviewed?

@fredrik-1
Copy link
Contributor Author

I want it reviewed. The bug is the string formating at the end of the docstring, i tclear the whole docstring. The decorator is just a way to get the docstring look at it was intended.

@jklymak jklymak added this to the v2.2-doc milestone Jun 21, 2018
@jklymak jklymak merged commit 41e406c into matplotlib:master Jun 21, 2018
lumberbot-app bot pushed a commit that referenced this pull request Jun 21, 2018
@fredrik-1 fredrik-1 deleted the doc_AxesBase_bug branch June 23, 2018 13:54
QuLogic added a commit that referenced this pull request Jul 5, 2018
…n-v2.2.2-doc

Backport PR #11442 on branch v2.2.2-doc
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants