From #5089 (comment)
In #5089 I removed the doc/README.rst from documentation, so now there's no reason for it to be an RST file. It's partially annoying because it now includes :orphan: at the top to signal it's not included anywhere. If it was a markdown file it would probably be nicer. It's also a little stale.