Synchronizing API and documentation updates

src/main/java/org/gitnex/tea4j/v2/apis/RepositoryApi.java

@@ -303,7 +303,7 @@ public interface RepositoryApi {
       @retrofit2.http.Path("index") Long index);
 
   /**
-   * Create or update multiple files in a repository
+   * Modify multiple files in a repository
    *
    * @param body (required)
    * @param owner owner of the repo (required)

src/main/java/org/gitnex/tea4j/v2/models/ChangeFileOperation.java

@@ -94,11 +94,11 @@ public class ChangeFileOperation implements Serializable {
   }
 
   /**
-   * content must be base64 encoded
+   * new or updated file content, must be base64 encoded
    *
    * @return content
    */
-  @Schema(required = true, description = "content must be base64 encoded")
+  @Schema(description = "new or updated file content, must be base64 encoded")
   public String getContent() {
     return content;
   }
@@ -155,7 +155,7 @@ public class ChangeFileOperation implements Serializable {
    *
    * @return path
    */
-  @Schema(description = "path to the existing or new file")
+  @Schema(required = true, description = "path to the existing or new file")
   public String getPath() {
     return path;
   }
@@ -170,12 +170,13 @@ public class ChangeFileOperation implements Serializable {
   }
 
   /**
-   * sha is the SHA for the file that already exists, required for update, delete
+   * sha is the SHA for the file that already exists, required for update or delete
    *
    * @return sha
    */
   @Schema(
-      description = "sha is the SHA for the file that already exists, required for update, delete")
+      description =
+          "sha is the SHA for the file that already exists, required for update or delete")
   public String getSha() {
     return sha;
   }

src/main/java/org/gitnex/tea4j/v2/models/ChangeFilesOptions.java

@@ -45,7 +45,7 @@ public class ChangeFilesOptions implements Serializable {
   private CommitDateOptions dates = null;
 
   @SerializedName("files")
-  private List<ChangeFileOperation> files = null;
+  private List<ChangeFileOperation> files = new ArrayList<>();
 
   @SerializedName("message")
   private String message = null;
@@ -140,19 +140,16 @@ public class ChangeFilesOptions implements Serializable {
   }
 
   public ChangeFilesOptions addFilesItem(ChangeFileOperation filesItem) {
-    if (this.files == null) {
-      this.files = new ArrayList<>();
-    }
     this.files.add(filesItem);
     return this;
   }
 
   /**
-   * Get files
+   * list of file operations
    *
    * @return files
    */
-  @Schema(description = "")
+  @Schema(required = true, description = "list of file operations")
   public List<ChangeFileOperation> getFiles() {
     return files;
   }