Move README content to actual docs?

[pllim]

You already have RTD set up, why not move the stuff from README to real docs so things can be rendered properly and maybe even doctested?

But if you must keep the content in README, your plot does not render well in dark mode.