Improved commenting.

src/main/java/au/org/democracydevelopers/raireservice/request/ContestRequest.java

@@ -18,7 +18,7 @@ the raire assertion generation engine (https://github.com/DemocracyDevelopers/ra
 import org.springframework.data.annotation.ReadOnlyProperty;
 
 /**
- * Request (expected to be json) describing a contest.
+ * Request (expected to be json) idenitfying a contest and listing its candidates.
  * This is an abstract class containing only the core input & validation for contests -
  * just the contest name and list of candidates, plus basic methods to check that they are
  * present, non-null and IRV.

src/main/java/au/org/democracydevelopers/raireservice/request/GenerateAssertionsRequest.java

@@ -16,7 +16,7 @@ the raire assertion generation engine (https://github.com/DemocracyDevelopers/ra
 import org.springframework.data.annotation.ReadOnlyProperty;
 
 /**
- * Request (expected to be json) describing the contest for which assertions should be generated.
+ * Request (expected to be json) identifying the contest for which assertions should be generated.
  * This extends ContestRequest and uses the contest name and candidate list, plus validations, from there.
  */
 public class GenerateAssertionsRequest extends ContestRequest {

src/main/java/au/org/democracydevelopers/raireservice/request/GetAssertionsRequest.java

@@ -17,7 +17,7 @@ the raire assertion generation engine (https://github.com/DemocracyDevelopers/ra
 import org.springframework.data.annotation.ReadOnlyProperty;
 
 /**
- * Request (expected to be json) describing the contest for which assertions should be retrieved
+ * Request (expected to be json) identifying the contest for which assertions should be retrieved
  * from the database (expected to be exported as json).
  * This extends ContestRequest and uses the contest name and candidate list, plus validations, from there.
  */