Added in @link and did other varrious improvements to the javadocs