some small doc updates

if you are ok with moving the rest of the todo.rst to the issue tracker, i can do that.