updates to rst files according to issue #6 and started for issue #8