DOC/CLN: Timezone section in timeseries.rst
State: closed

- Shortened some of the examples to show the minimum, necessary functionality
- Removed some redundant examples
- Refactored the ambiguous times handling section
- Showcase `tz_localize` more in the beginning of the section & noted that pandas doesn't support `datetime.timezone` objects yet


Labels:
name: Docs
name: Timezones
description: Timezone data dtype
name: Clean

Comments:
<img width="762" alt="screen shot 2019-01-18 at 2 15 08 pm" src="https://user-images.githubusercontent.com/10647082/51368951-78c1f980-1b2c-11e9-9286-7b061fcb818d.png">
<img width="758" alt="screen shot 2019-01-18 at 2 15 17 pm" src="https://user-images.githubusercontent.com/10647082/51368955-7bbcea00-1b2c-11e9-91a4-d2cb38d2b9eb.png">
<img width="757" alt="screen shot 2019-01-18 at 2 15 27 pm" src="https://user-images.githubusercontent.com/10647082/51368959-80819e00-1b2c-11e9-9c76-28c09394ff0b.png">
<img width="770" alt="screen shot 2019-01-18 at 2 15 37 pm" src="https://user-images.githubusercontent.com/10647082/51368961-84152500-1b2c-11e9-9080-56e6d70b8364.png">
<img width="771" alt="screen shot 2019-01-18 at 2 15 48 pm" src="https://user-images.githubusercontent.com/10647082/51368964-87101580-1b2c-11e9-86b3-383b30883b5c.png">
<img width="775" alt="screen shot 2019-01-18 at 2 15 57 pm" src="https://user-images.githubusercontent.com/10647082/51368967-8a0b0600-1b2c-11e9-8aae-c3c1c5bb3076.png">
<img width="777" alt="screen shot 2019-01-18 at 2 16 07 pm" src="https://user-images.githubusercontent.com/10647082/51368970-8e372380-1b2c-11e9-87bd-322b3414e105.png">
<img width="772" alt="screen shot 2019-01-18 at 2 16 15 pm" src="https://user-images.githubusercontent.com/10647082/51368973-91321400-1b2c-11e9-97b7-281bea83ca22.png">
<img width="765" alt="screen shot 2019-01-18 at 2 16 24 pm" src="https://user-images.githubusercontent.com/10647082/51368980-942d0480-1b2c-11e9-88e5-a96f70a3330b.png">
<img width="773" alt="screen shot 2019-01-18 at 2 16 30 pm" src="https://user-images.githubusercontent.com/10647082/51368984-968f5e80-1b2c-11e9-8e30-f3a8638f0a4b.png">

# [Codecov](https://codecov.io/gh/pandas-dev/pandas/pull/24825?src=pr&el=h1) Report
> Merging [#24825](https://codecov.io/gh/pandas-dev/pandas/pull/24825?src=pr&el=desc) into [master](https://codecov.io/gh/pandas-dev/pandas/commit/5e224fb8b474df8e7d8053bfbae171f500a65f54?src=pr&el=desc) will **decrease** coverage by `<.01%`.
> The diff coverage is `n/a`.

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

```diff
@@            Coverage Diff             @@
##           master   #24825      +/-   ##
==========================================
- Coverage   92.37%   92.36%   -0.01%     
==========================================
  Files         166      166              
  Lines       52404    52404              
==========================================
- Hits        48406    48405       -1     
- Misses       3998     3999       +1
```

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

| [Impacted Files](https://codecov.io/gh/pandas-dev/pandas/pull/24825?src=pr&el=tree) | Coverage Δ | |
|---|---|---|
| [pandas/util/testing.py](https://codecov.io/gh/pandas-dev/pandas/pull/24825/diff?src=pr&el=tree#diff-cGFuZGFzL3V0aWwvdGVzdGluZy5weQ==) | `88.04% <0%> (-0.1%)` | :arrow_down: |

------

[Continue to review full report at Codecov](https://codecov.io/gh/pandas-dev/pandas/pull/24825?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/24825?src=pr&el=footer). Last update [5e224fb...c587781](https://codecov.io/gh/pandas-dev/pandas/pull/24825?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/24825?src=pr&el=h1) Report
> Merging [#24825](https://codecov.io/gh/pandas-dev/pandas/pull/24825?src=pr&el=desc) into [master](https://codecov.io/gh/pandas-dev/pandas/commit/512830b46e678a1c6bd86cc60f54d74ff75792db?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/24825/graphs/tree.svg?width=650&token=eZ4WkYLtcO&height=150&src=pr)](https://codecov.io/gh/pandas-dev/pandas/pull/24825?src=pr&el=tree)

```diff
@@           Coverage Diff           @@
##           master   #24825   +/-   ##
=======================================
  Coverage   92.38%   92.38%           
=======================================
  Files         166      166           
  Lines       52379    52379           
=======================================
  Hits        48392    48392           
  Misses       3987     3987
```

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


------

[Continue to review full report at Codecov](https://codecov.io/gh/pandas-dev/pandas/pull/24825?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/24825?src=pr&el=footer). Last update [512830b...e6eea26](https://codecov.io/gh/pandas-dev/pandas/pull/24825?src=pr&el=lastupdated). Read the [comment docs](https://docs.codecov.io/docs/pull-request-comments).

Thanks. Addressed the comments.
lgtm. @TomAugspurger could merge to 0.24.1 if you'd like.
I think we agreed that backporting doc fixes wasn't worth the hassle.