updating Scaladoc

adding links, space when there is no space bet a parameter its description, fixing wording