some doc additions
documentation improvements
gitignore minor