added package documentation
added scaladoc
added intention
dropped deprecated class
added documentation
dropped deprecated class
added doc todos
dropped deprecated class