DOC: Various doc fixes
State: closed

- Fixed spacing
- Fixed method reference
- Fixed list line wrapping
- Fixed unbalanced ticks
- Fixed section-heading without colon
- Changed Interval Properties -> Attributes
- Changed Styler properties

xref https://github.com/pandas-dev/pandas/issues/16033

Will probably do more as followups, so let's keep that open.

Labels:
name: Docs

Comments:
@TomAugspurger maybe leave the changes to the html repr for a separate PR?
Sorry, when I pushed I didn't realize I was experimenting on this branch.
Be previous commit removed one of the changes, but I missed `core/frame.py`

On Tue, Apr 18, 2017 at 9:06 AM, Joris Van den Bossche <
notifications@github.com> wrote:

> @TomAugspurger <https://github.com/TomAugspurger> maybe leave the changes
> to the html repr for a separate PR?
>
> —
> You are receiving this because you were mentioned.
> Reply to this email directly, view it on GitHub
> <https://github.com/pandas-dev/pandas/pull/16035#issuecomment-294855303>,
> or mute the thread
> <https://github.com/notifications/unsubscribe-auth/ABQHIqtgO3dLzWWwoz1WbsVBGpyfF-Xoks5rxMNIgaJpZM4M_QXC>
> .
>

Doc build passed. Remaining warnings

```
WARNING: could not import _license.show_info
[31mWARNING: while setting up extension conf.py: directive 'autosummary' is already registered, it will be overridden
[31mWARNING: [autosummary] failed to import 'pandas.DataFrame.columns': no module named pandas.DataFrame.columns
[39;49;00m[31mWARNING: [autosummary] failed to import 'pandas.DataFrame.index': no module named pandas.DataFrame.index
[39;49;00m[31mWARNING: [autosummary] failed to import 'pandas.Panel.items': no module named pandas.Panel.items
[39;49;00m[31mWARNING: [autosummary] failed to import 'pandas.Panel.major_axis': no module named pandas.Panel.major_axis
[39;49;00m[31mWARNING: [autosummary] failed to import 'pandas.Panel.minor_axis': no module named pandas.Panel.minor_axis
[39;49;00m[31mWARNING: [autosummary] failed to import 'pandas.Series.index': no module named pandas.Series.index
[31m/tmp/doc/source/generated/pandas.IntervalIndex.rst:57: WARNING: toctree references unknown document 'generated/pandas.IntervalIndex.str'
[39;49;00m[31m/home/travis/build/pandas-dev/pandas/pandas/core/groupby.py:docstring of pandas.core.groupby.DataFrameGroupBy.describe:16: WARNING: Block quote ends without a blank line; unexpected unindent.
[39;49;00m[31m/home/travis/build/pandas-dev/pandas/pandas/core/groupby.py:docstring of pandas.core.groupby.SeriesGroupBy.nlargest:12: WARNING: Block quote ends without a blank line; unexpected unindent.
[39;49;00m[31m/home/travis/build/pandas-dev/pandas/pandas/core/groupby.py:docstring of pandas.core.groupby.SeriesGroupBy.nsmallest:12: WARNING: Block quote ends without a blank line; unexpected unindent.
[39;49;00m[31m/home/travis/build/pandas-dev/pandas/pandas/io/parsers.py:docstring of pandas.read_csv:158: WARNING: Inline interpreted text or phrase reference start-string without end-string.
[39;49;00m[31m/home/travis/build/pandas-dev/pandas/pandas/io/parsers.py:docstring of pandas.read_fwf:157: WARNING: Inline interpreted text or phrase reference start-string without end-string.
[39;49;00m[31m/home/travis/build/pandas-dev/pandas/pandas/io/parsers.py:docstring of pandas.read_table:158: WARNING: Inline interpreted text or phrase reference start-string without end-string.
[39;49;00m[31m/tmp/doc/source/overview.rst:120: WARNING: Include file '/tmp/LICENSE' not found or reading it failed
[39;49;00m[31minternal padding after source/whatsnew/v0.8.0.txt:15: WARNING: image file not readable: ../_static/whatsnew_secondary_y.png
[39;49;00m[31minternal padding after source/whatsnew/v0.8.0.txt:19: WARNING: image file not readable: ../_static/whatsnew_kde.png
[31mNone:None: WARNING: toctree contains reference to nonexisting document 'generated/pandas.IntervalIndex.str'
[39;49;00m[31m/home/travis/build/pandas-dev/pandas/pandas/core/indexes/interval.py:docstring of pandas.IntervalIndex:None: WARNING: toctree contains reference to nonexisting document 'generated/pandas.IntervalIndex.str'
[39;49;00m[31mNone:None: WARNING: toctree contains reference to nonexisting document 'generated/pandas.IntervalIndex.str'
[39;49;00m[31msource/whatsnew/v0.19.0.txt:482: WARNING: undefined label: io.bigquery_authentication (if the link has no caption the label must precede a section header)
[39;49;00m[31msource/whatsnew/v0.17.1.txt:60: WARNING: undefined label: style (if the link has no caption the label must precede a section header)
```

I might have a fix for the DataFrame.index, DataFrame.columns warnings, but not before the release.

I'm not really sure about the IntervalIndex.str warnings.
@TomAugspurger OK to merge this one? (minus the remaining change to the html)
> I might have a fix for the DataFrame.index, DataFrame.columns warnings, but not before the release.

Yeah, some of those warnings have been there already a very long time, so those are not very important for the release.

> I'm not really sure about the IntervalIndex.str warnings.

This should probably be done similar as DatetimeIndex.str, will fix that
> minus the remaining change to the html

https://github.com/pandas-dev/pandas/pull/16035/commits/0b6796173d60dfde499c009da980585120ea75e0 removed that, but if you want to double check before merging.
# [Codecov](https://codecov.io/gh/pandas-dev/pandas/pull/16035?src=pr&el=h1) Report
> Merging [#16035](https://codecov.io/gh/pandas-dev/pandas/pull/16035?src=pr&el=desc) into [master](https://codecov.io/gh/pandas-dev/pandas/commit/816f94575c9ec1af2169a28536217c4d16dd6b4b?src=pr&el=desc) will **decrease** coverage by `0.01%`.
> The diff coverage is `100%`.

[![Impacted file tree graph](https://codecov.io/gh/pandas-dev/pandas/pull/16035/graphs/tree.svg?token=eZ4WkYLtcO&src=pr&height=150&width=650)](https://codecov.io/gh/pandas-dev/pandas/pull/16035?src=pr&el=tree)

```diff
@@            Coverage Diff             @@
##           master   #16035      +/-   ##
==========================================
- Coverage   90.79%   90.77%   -0.02%     
==========================================
  Files         156      156              
  Lines       50534    50535       +1     
==========================================
- Hits        45882    45873       -9     
- Misses       4652     4662      +10
```

| Flag | Coverage Δ | |
|---|---|---|
| #multiple | `88.54% <100%> (-0.02%)` | :arrow_down: |
| #single | `40.44% <0%> (-0.01%)` | :arrow_down: |

| [Impacted Files](https://codecov.io/gh/pandas-dev/pandas/pull/16035?src=pr&el=tree) | Coverage Δ | |
|---|---|---|
| [pandas/core/generic.py](https://codecov.io/gh/pandas-dev/pandas/pull/16035?src=pr&el=tree#diff-cGFuZGFzL2NvcmUvZ2VuZXJpYy5weQ==) | `91.29% <ø> (ø)` | :arrow_up: |
| [pandas/io/formats/style.py](https://codecov.io/gh/pandas-dev/pandas/pull/16035?src=pr&el=tree#diff-cGFuZGFzL2lvL2Zvcm1hdHMvc3R5bGUucHk=) | `96.28% <ø> (ø)` | :arrow_up: |
| [pandas/core/frame.py](https://codecov.io/gh/pandas-dev/pandas/pull/16035?src=pr&el=tree#diff-cGFuZGFzL2NvcmUvZnJhbWUucHk=) | `97.65% <100%> (ø)` | :arrow_up: |
| [pandas/plotting/\_converter.py](https://codecov.io/gh/pandas-dev/pandas/pull/16035?src=pr&el=tree#diff-cGFuZGFzL3Bsb3R0aW5nL19jb252ZXJ0ZXIucHk=) | `63.54% <0%> (-1.82%)` | :arrow_down: |
| [pandas/util/testing.py](https://codecov.io/gh/pandas-dev/pandas/pull/16035?src=pr&el=tree#diff-cGFuZGFzL3V0aWwvdGVzdGluZy5weQ==) | `79.81% <0%> (+0.18%)` | :arrow_up: |

------

[Continue to review full report at Codecov](https://codecov.io/gh/pandas-dev/pandas/pull/16035?src=pr&el=continue).
> **Legend** - [Click here to learn more](https://docs.codecov.io/docs/codecov-delta)
> `Δ = absolute <relative> (impact)`, `ø = not affected`, `? = missing data`
> Powered by [Codecov](https://codecov.io/gh/pandas-dev/pandas/pull/16035?src=pr&el=footer). Last update [816f945...0b67961](https://codecov.io/gh/pandas-dev/pandas/pull/16035?src=pr&el=lastupdated). Read the [comment docs](https://docs.codecov.io/docs/pull-request-comments).

# [Codecov](https://codecov.io/gh/pandas-dev/pandas/pull/16035?src=pr&el=h1) Report
> Merging [#16035](https://codecov.io/gh/pandas-dev/pandas/pull/16035?src=pr&el=desc) into [master](https://codecov.io/gh/pandas-dev/pandas/commit/816f94575c9ec1af2169a28536217c4d16dd6b4b?src=pr&el=desc) will **not change** coverage.
> The diff coverage is `n/a`.

[![Impacted file tree graph](https://codecov.io/gh/pandas-dev/pandas/pull/16035/graphs/tree.svg?src=pr&token=eZ4WkYLtcO&width=650&height=150)](https://codecov.io/gh/pandas-dev/pandas/pull/16035?src=pr&el=tree)

```diff
@@           Coverage Diff           @@
##           master   #16035   +/-   ##
=======================================
  Coverage   90.79%   90.79%           
=======================================
  Files         156      156           
  Lines       50534    50534           
=======================================
  Hits        45882    45882           
  Misses       4652     4652
```

| Flag | Coverage Δ | |
|---|---|---|
| #multiple | `88.56% <ø> (ø)` | :arrow_up: |
| #single | `40.44% <ø> (ø)` | :arrow_up: |

| [Impacted Files](https://codecov.io/gh/pandas-dev/pandas/pull/16035?src=pr&el=tree) | Coverage Δ | |
|---|---|---|
| [pandas/io/formats/style.py](https://codecov.io/gh/pandas-dev/pandas/pull/16035?src=pr&el=tree#diff-cGFuZGFzL2lvL2Zvcm1hdHMvc3R5bGUucHk=) | `96.28% <ø> (ø)` | :arrow_up: |
| [pandas/core/generic.py](https://codecov.io/gh/pandas-dev/pandas/pull/16035?src=pr&el=tree#diff-cGFuZGFzL2NvcmUvZ2VuZXJpYy5weQ==) | `91.29% <ø> (ø)` | :arrow_up: |

------

[Continue to review full report at Codecov](https://codecov.io/gh/pandas-dev/pandas/pull/16035?src=pr&el=continue).
> **Legend** - [Click here to learn more](https://docs.codecov.io/docs/codecov-delta)
> `Δ = absolute <relative> (impact)`, `ø = not affected`, `? = missing data`
> Powered by [Codecov](https://codecov.io/gh/pandas-dev/pandas/pull/16035?src=pr&el=footer). Last update [816f945...0b67961](https://codecov.io/gh/pandas-dev/pandas/pull/16035?src=pr&el=lastupdated). Read the [comment docs](https://docs.codecov.io/docs/pull-request-comments).

thanks!

How did you fix the Styler warnings in the end? As I see you reverted what you changed regarding the properties
`template:` -> `template :` 😄 

I have no idea why the first triggered an attempted import.

The properties were nice for the docs, but you couldn't use them as class attributes anymore, which is convenient.
> template: -> template : :smile:

rst .. (or numpydoc maybe in this case) :-)