actually read the docs closes #12