Skip to content

DOC: Fix broken formatting on docstring examples with first-line comments #9803

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
Apr 28, 2015

Conversation

evanpw
Copy link
Contributor

@evanpw evanpw commented Apr 3, 2015

@jorisvandenbossche
Copy link
Member

Thanks for noticing! But, the 'correct' solution is that there should be a blank line between the explanation and the code. In this way the code-block is not needed, which looks a bit nicer in raw format.

Also the # is not needed then, so this can be removed as well.

see https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt#sections for a reference

@jorisvandenbossche
Copy link
Member

But very welcome to update the PR!

@jorisvandenbossche jorisvandenbossche added this to the 0.16.1 milestone Apr 3, 2015
@jreback
Copy link
Contributor

jreback commented Apr 28, 2015

@jorisvandenbossche ?

@jorisvandenbossche
Copy link
Member

Yes, forgot about this.
@evanpw Is looking good! Can you squash?

@evanpw evanpw force-pushed the interpolate_example branch from 1eb75d6 to 856bf21 Compare April 28, 2015 11:56
@evanpw
Copy link
Contributor Author

evanpw commented Apr 28, 2015

Squashed

@jorisvandenbossche
Copy link
Member

Thanks!

jorisvandenbossche added a commit that referenced this pull request Apr 28, 2015
DOC: Fix broken formatting on docstring examples with first-line comments
@jorisvandenbossche jorisvandenbossche merged commit f7e0f16 into pandas-dev:master Apr 28, 2015
@evanpw evanpw deleted the interpolate_example branch April 28, 2015 12:02
@evanpw evanpw restored the interpolate_example branch September 19, 2015 00:34
@evanpw evanpw deleted the interpolate_example branch September 19, 2015 00:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants