Handwritten Javadoc edits

Author: Caitlin Bales (MSFT)

src/main/java/com/microsoft/graph/core/BaseActionRequestBuilder.java

@@ -40,7 +40,7 @@ public BaseActionRequestBuilder(
      * Checks if the parameter map contains a object accessible by the supplied key
      *
      * @param name The key used to access the stored body parameter
-     * @return true, if {@link BaseActionRequestBuilder#mBodyParams} contains the key, otherwise false
+     * @return true, if {@link BaseActionRequestBuilder#bodyParams} contains the key, otherwise false
      */
     protected boolean hasParameter(final String name) {
         return bodyParams.containsKey(name);

src/main/java/com/microsoft/graph/core/ClientException.java

@@ -33,7 +33,6 @@ public class ClientException extends RuntimeException {
      * Creates the client exception.
      * @param message The message to display.
      * @param ex The exception from.
-     * @param errorCode The error code for this exception.
      */
     public ClientException(final String message, final Throwable ex) {
         super(message, ex);

src/main/java/com/microsoft/graph/models/extensions/Multipart.java

@@ -29,7 +29,7 @@ public Multipart() {
 
 	/**
 	 * Get the multipart boundary for use in the request header
-	 * @return
+	 * @return The multipart boundary
 	 */
 	public String boundary() {
 		return boundary;
@@ -40,7 +40,7 @@ public String boundary() {
 	 * @param name The name of the part
 	 * @param contentType The MIME type (text/html, text/plain, etc.)
 	 * @param content The string content to include
-	 * @throws IOException
+	 * @throws IOException Throws an exception if the output stream cannot be written to
 	 */
 	public void addPart(String name, String contentType, String content) throws IOException {
 		addPart(name, contentType, content.getBytes());
@@ -51,7 +51,7 @@ public void addPart(String name, String contentType, String content) throws IOEx
 	 * @param name The name of the part
 	 * @param contentType The MIME type (text/html, video/mp4, etc.)
 	 * @param byteArray The byte[] contents of the resource
-	 * @throws IOException
+	 * @throws IOException Throws an exception if the output stream cannot be written to
 	 */
 	public void addPart(String name, String contentType, byte[] byteArray) throws IOException {
 		String partContent = addBoundary();
@@ -69,7 +69,7 @@ public void addPart(String name, String contentType, byte[] byteArray) throws IO
 	 * Add an HTML part to the multipart body
 	 * @param name The name of the part
 	 * @param content The HTML body for the part
-	 * @throws IOException
+	 * @throws IOException Throws an exception if the output stream cannot be written to
 	 */
 	public void addHtmlPart(String name, String content) throws IOException {
 		addPart(name, "text/html", content);
@@ -79,7 +79,7 @@ public void addHtmlPart(String name, String content) throws IOException {
 	 * Add an image part to the multipart body
 	 * @param name The name of the part
 	 * @param imageFile The image file
-	 * @throws IOException
+	 * @throws IOException Throws an exception if the output stream cannot be written to
 	 */
 	public void addImagePart(String name, java.io.File imageFile) throws IOException {
 		addFilePart(name, "image/jpeg", imageFile);
@@ -90,7 +90,7 @@ public void addImagePart(String name, java.io.File imageFile) throws IOException
 	 * @param name The name of the part
 	 * @param contentType The MIME type of the file (application/pdf, video/mp4, etc.)
 	 * @param file The file
-	 * @throws IOException
+	 * @throws IOException Throws an exception if the output stream cannot be written to
 	 */
 	public void addFilePart(String name, String contentType, java.io.File file) throws IOException {
 		InputStream fileStream = new FileInputStream(file);
@@ -100,15 +100,15 @@ public void addFilePart(String name, String contentType, java.io.File file) thro
 
 	/**
 	 * Adds a boundary at the beginning of a new part
-	 * @return
+	 * @return The boundary
 	 */
 	private String addBoundary() {
 		return "--" + boundary + RETURN;
 	}
 
 	/**
 	 * Adds a boundary at the end of the multipart body
-	 * @return
+	 * @return The boundary
 	 */
 	private String addEnding() {
 		return "--" + boundary + "--";
@@ -117,7 +117,7 @@ private String addEnding() {
 	/**
 	 * Returns a full multipart body byte array
 	 * @return The byte[] representation of the multipart object
-	 * @throws IOException
+	 * @throws IOException Throws an exception if the output stream cannot be written to
 	 */
 	public byte[] content() throws IOException {
 		ByteArrayOutputStream finalStream = out;
@@ -129,7 +129,7 @@ public byte[] content() throws IOException {
      * Helper method to convert an InputStream to a byte[]
      * @param in The input stream to convert
      * @return The byte[]
-     * @throws IOException 
+     * @throws IOException Throws an exception if the output stream cannot be written to
      */
     private byte[] getByteArray(InputStream in) throws IOException {
             ByteArrayOutputStream buffer = new ByteArrayOutputStream();

src/main/java/com/microsoft/graph/models/extensions/PlannerAssignedToTaskBoardTaskFormat.java

@@ -35,6 +35,9 @@ public class PlannerAssignedToTaskBoardTaskFormat extends BasePlannerAssignedToT
 
 	/**
 	 * The GetOrderHintForAssignee
+	 * 
+	 * @param userId The assignee ID to get the order hint for
+	 * @return The order hint for the given user
 	 */
 	public String orderHintForAssignee(String userId)
 	{

src/main/java/com/microsoft/graph/serializer/IJsonBackedObject.java

@@ -38,9 +38,8 @@ public interface IJsonBackedObject {
     void setRawObject(final ISerializer serializer, final JsonObject json);
 
     /**
-     * TODO Document
-     *
-     * @return
+     * Provides access to objects not anticipated in the model, as well as 
+     * request and response data from the HTTP call
      */
     AdditionalDataManager additionalDataManager();