Updated javadocs and added Upgrade notes. Added section to start adding
additional tests to be completed by Craig or Dylan in future.