Fix RST docs to run correctly and be more clear