DOC: Add comparison with Stata page to documentation
State: closed

- [ ] closes #####
- [ ] tests added / passed
- [ ] passes `git diff upstream/master -u -- "*.py" | flake8 --diff`
- [ ] whatsnew entry

I noticed that the pandas documentation has pages for [Comparison with SAS](https://pandas.pydata.org/pandas-docs/stable/comparison_with_sas.html), [Comparison with R](https://pandas.pydata.org/pandas-docs/stable/comparison_with_r.html) and [Comparison with SQL](https://pandas.pydata.org/pandas-docs/stable/comparison_with_sql.html), but nothing for newcomers from Stata.

This is heavily based off of the "Comparison with SAS" page, with all the examples and discussion fixed for Stata.

Labels:
name: Docs
name: IO Stata
description: read_stata, to_stata

Comments:
When I recompile with `python make.py html`, the command line interface still asks me
> Running Sphinx v1.7.1
> I'm about to DELETE the following:
> ['comparison_with_stata.rst']
>
> WARNING: I'd like to delete those to speed up processing (yes/no)? 

Is there a configuration file somewhere that I should add this document to?
you need to add to the ``pandas/doc/source/index.rst.template``
# [Codecov](https://codecov.io/gh/pandas-dev/pandas/pull/19945?src=pr&el=h1) Report
> Merging [#19945](https://codecov.io/gh/pandas-dev/pandas/pull/19945?src=pr&el=desc) into [master](https://codecov.io/gh/pandas-dev/pandas/commit/36ac1dd1aea6e32896695c5e174e7658b462437d?src=pr&el=desc) will **increase** coverage by `0.02%`.
> The diff coverage is `n/a`.

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

```diff
@@            Coverage Diff             @@
##           master   #19945      +/-   ##
==========================================
+ Coverage   91.82%   91.84%   +0.02%     
==========================================
  Files         152      152              
  Lines       49261    49261              
==========================================
+ Hits        45233    45245      +12     
+ Misses       4028     4016      -12
```

| Flag | Coverage Δ | |
|---|---|---|
| #multiple | `90.23% <ø> (+0.02%)` | :arrow_up: |
| #single | `41.9% <ø> (ø)` | :arrow_up: |

| [Impacted Files](https://codecov.io/gh/pandas-dev/pandas/pull/19945?src=pr&el=tree) | Coverage Δ | |
|---|---|---|
| [pandas/plotting/\_converter.py](https://codecov.io/gh/pandas-dev/pandas/pull/19945/diff?src=pr&el=tree#diff-cGFuZGFzL3Bsb3R0aW5nL19jb252ZXJ0ZXIucHk=) | `66.81% <0%> (+1.73%)` | :arrow_up: |

------

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

can you render and post this section
I rendered it with `python make.py html`, and it looks fine, but Github doesn't let me attach an html file to an issue. How should I post it?

It seems like the Travis build failed from the time limit?
> The job exceeded the maximum time limit for jobs, and has been terminated.

https://travis-ci.org/pandas-dev/pandas/jobs/347824581#L2729
@jreback What can I do to get this merged?
The CircleCI build is failing on two TSPlot tests, which seem to be unrelated to this PR.
Ping!
Thanks @kylebarron !