some issues in the docs