change docs to rst format and make them a bit clearer