Fix javadoc warnings

This fixes the existing error: !141 (merged) , but there are a number of warnings remaining.

To run javadoc and generate the list of warnings:

./gradlew javadoc

• fix the warnings

• add javadoc as a pipeline task, so new errors are not introduced

• Depends on #158 (closed)