update to documentation and scaladocs