I used to write docs with [markdown][1] which, honestly, it's much more agile and less more fragile than ReST (which is a PITA). Then I use [pandoc][1] to convert form `md` markup to `rst` markup. That's why in the `simple-sample` project you find the original `README.md`. My personal opinion is that ReST sucks a lot. But I understand that all your docs are produced from it. No problem to remove it.