update documentation for r10. closes #1