Convert README.rst to Markdown

[hydrosquall]

RST is harder to work with and shrinking in usage. If we can confirm that markdown works well for the pieces that depend on it (sphinx docs, Python Package warehouse), the project documentation will be easier to maintain. It will also make adhering to projects like the all-contributors specification easier.

https://github.com/all-contributors/all-contributors

[hootnot]

If you stick with RST you should change the header from:

=============
Tiingo Python
=============

to:

Tiingo Python
=============

then pypi.org will render the README.rst correct

[hydrosquall]

Oh, I had been wondering about why that wasn’t working! Thank you for catching that. If you’re interested in filing a PR for this I will merge it, otherwise I’ll get to it when I deploy a new tiingo version this weekend.

…

On Tue, May 7, 2019 at 7:51 AM Feite Brekeveld ***@***.***> wrote: If you stick with RST you should change the header from: ============= Tiingo Python ============= to: Tiingo Python ============= then pypi.org will render the README.rst correct — You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub <#266 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/ACE2MM7OOQXL7CUPFIP7NSLPUFUL5ANCNFSM4HK4ANHA> .

[hootnot]

Hi, pls. make the change yourself and bundle it with your deploy for the weekend.
You should also check all other headers for the length of '-' or other valid header markup characters.

I'm not sure if these would break the rendering, but the specs say the length should be equal.

Cheers

[hydrosquall]

By default, an upload's description will render with reStructuredText. If the description is in an alternate format like Markdown, a package may set the long_description_content_type in setup.py to the alternate format.

Learned today that this can be linted using the readme_renderer, via twine check dist/*. The last remaining linting issue was to ensure that every underline is at least as long as the preceding line.