Scaladoc corrections and improvements

- Correcting bad links to and out of date documentation that has carried over from previous versions.
- Adding new and improving exisiting documentation.