Currently, some documentations are written in Markdown while some are in ReStructuredText. I think it's better to use a consistent format so that new contributors won't be confused.

Here are the .rst files in the repository:

$ find . -name '*.rst'
./README.rst
./doc/install.rst
./doc/overview.rst
./doc/index.rst
./doc/api/index.rst
./doc/_templates/autosummary/module.rst
./doc/_templates/autosummary/class.rst
./doc/_templates/autosummary/exception.rst
./doc/_templates/autosummary/method.rst
./doc/_templates/autosummary/base.rst
./doc/_templates/autosummary/function.rst

I think at least the following three files should be converted to markdown:

• README.rst doc: Convert README from ReST to Markdown #3059
• doc/install.rst doc: Convert the installation guides source code from ReST to Markdown #2992
• doc/overview.rst doc: Convert overview source code from ReST to Markdown #2953

Comments?