Add JavaDoc stating that existing Terms be used for Category or Tags when using the builder.

johanmynhardt · johanmynhardt · commit 1af1555e8ce6 · 2017-08-07T12:57:56.000+02:00
diff --git a/src/main/java/com/afrozaar/wordpress/wpapi/v2/model/builder/PostBuilder.java b/src/main/java/com/afrozaar/wordpress/wpapi/v2/model/builder/PostBuilder.java
@@ -128,20 +128,32 @@ public PostBuilder withPingStatus(String pingStatus) {
         return this;
     }
 
+    /**
+     * Add existing categories when building a post.
+     */
     public PostBuilder withCategories(List<Long> categoryIds) {
         this.categoryIds = categoryIds;
         return this;
     }
 
+    /**
+     * Add existing tags when building a post.
+     */
     public PostBuilder withTags(List<Long> tagIds) {
         this.tagIds = tagIds;
         return this;
     }
 
+    /**
+     * Add existing Category term items when building a post.
+     */
     public PostBuilder withCategories(Term... terms) {
         return withCategories(Arrays.stream(terms).map(Term::getId).collect(toList()));
     }
 
+    /**
+     * Add existing Tag term items when building a post.
+     */
     public PostBuilder withTags(Term... tags) {
         return withTags(Arrays.stream(tags).map(Term::getId).collect(toList()));
     }

Original file line number	Diff line number	Diff line change
`@@ -128,20 +128,32 @@ public PostBuilder withPingStatus(String pingStatus) {`
`128`	`128`	`return this;`
`129`	`129`	`}`
`130`	`130`
	`131`	`+ /**`
	`132`	`+ * Add existing categories when building a post.`
	`133`	`+ */`
`131`	`134`	`public PostBuilder withCategories(List<Long> categoryIds) {`
`132`	`135`	`this.categoryIds = categoryIds;`
`133`	`136`	`return this;`
`134`	`137`	`}`
`135`	`138`
	`139`	`+ /**`
	`140`	`+ * Add existing tags when building a post.`
	`141`	`+ */`
`136`	`142`	`public PostBuilder withTags(List<Long> tagIds) {`
`137`	`143`	`this.tagIds = tagIds;`
`138`	`144`	`return this;`
`139`	`145`	`}`
`140`	`146`
	`147`	`+ /**`
	`148`	`+ * Add existing Category term items when building a post.`
	`149`	`+ */`
`141`	`150`	`public PostBuilder withCategories(Term... terms) {`
`142`	`151`	`return withCategories(Arrays.stream(terms).map(Term::getId).collect(toList()));`
`143`	`152`	`}`
`144`	`153`
	`154`	`+ /**`
	`155`	`+ * Add existing Tag term items when building a post.`
	`156`	`+ */`
`145`	`157`	`public PostBuilder withTags(Term... tags) {`
`146`	`158`	`return withTags(Arrays.stream(tags).map(Term::getId).collect(toList()));`
`147`	`159`	`}`