added package docs and clarified some doc comments