real documentation. closes #49