better documentation and reST fixes