reword javadoc and documentation

Author: rob93c

PRIVACY_POLICY.md

@@ -20,7 +20,7 @@ For the purposes of this Privacy Policy:
 - __Affiliate__ means an entity that controls, is controlled by or is under common control with a party, where "control" means ownership of 50% or more of the shares, equity interest or other securities entitled to vote for election of directors or other managing authority.
 - __Application__ refers to Stickerify, the software program provided by the Company.
 - __Company__ (referred to as either "the Company", "We", "Us" or "Our" in this Agreement) refers to Stickerify.
-- __Country__ refers to:  Italy
+- __Country__ refers to: Italy
 - __Device__ means any device that can access the Service such as a computer, a cellphone or a digital tablet.
 - __Personal Data__ is any information that relates to an identified or identifiable individual.
 - __Service__ refers to the Application.

README.md

@@ -22,7 +22,7 @@ to convert.
 
 Based on what you send, [Stickerify](https://t.me/StickerifyImageBot) will answer the following:
 
-* the converted media, if you sent a supported file (images, gifs, videos, and existing Telegram stickers are supported)
+* the converted media, if you sent a supported file (images, GIFs, videos, and existing Telegram stickers are supported)
   that needed conversion
 * no file, if you sent a media already suiting Telegram's requirements
 * an error message, if you sent either an unsupported or a corrupted file
@@ -88,7 +88,7 @@ After you successfully set up the project, you will have to go through the follo
        docker pull rob93c/stickerify
        ```
 
-3. Now you just need to run the Docker image passing the token (`{{TOKEN}}`) retrieved
+3. Now you need to run the Docker image passing the token (`{{TOKEN}}`) retrieved
    from [BotFather](https://t.me/BotFather):
 
    ```shell
@@ -111,7 +111,7 @@ If you would like to improve [Stickerify](https://t.me/StickerifyImageBot) as pa
 the [contributing guidelines](CONTRIBUTING.md) and then consider opening a new issue _and/or_ pull request.
 
 If your pull request represents a valid contribution to the project, it will be marked as `hacktoberfest-accepted`,
-therefore counting towards the 4 contributions goal.
+therefore counting towards the four-contribution goal.
 
 ## Useful information
 

src/main/java/com/github/stickerifier/stickerify/logger/ExceptionHighlighter.java

@@ -12,7 +12,7 @@
 import ch.qos.logback.core.pattern.Converter;
 
 /**
- * Custom converter class to be used by Logback in order to highlight important substrings in exception logs.
+ * Custom converter class to be used by Logback to highlight important substrings in exception logs.
  *
  * @see Converter
  */

src/main/java/com/github/stickerifier/stickerify/logger/MessageHighlighter.java

@@ -15,7 +15,7 @@
 import ch.qos.logback.core.pattern.Converter;
 
 /**
- * Custom converter class to be used by Logback in order to highlight important substrings.
+ * Custom converter class to be used by Logback to highlight important substrings.
  *
  * @see Converter
  */

src/main/java/com/github/stickerifier/stickerify/media/MediaHelper.java

@@ -92,7 +92,7 @@ public static File convert(File inputFile) throws MediaException {
 	}
 
 	/**
-	 * Analyses the file in order to detect its media type.
+	 * Analyzes the file to detect its media type.
 	 *
 	 * @param file the file sent to the bot
 	 * @return the MIME type of the passed-in file
@@ -113,7 +113,7 @@ private static String detectMimeType(File file) {
 
 	/**
 	 * Checks if the file is a {@code gzip} archive, then it reads its content and verifies if it's a valid JSON.
-	 * Once JSON information are retrieved, they are validated against Telegram's requirements.
+	 * Once JSON information is retrieved, they are validated against Telegram's requirements.
 	 *
 	 * @param file the file to check
 	 * @param mimeType the MIME type of the file
@@ -179,7 +179,7 @@ private static boolean isAnimationCompliant(AnimationDetails animation) {
 	}
 
 	/**
-	 * Checks that passed-in file's size does not exceed specified threshold.
+	 * Checks that passed-in file's size does not exceed the specified threshold.
 	 *
 	 * @param file the file to check
 	 * @param threshold max allowed file size
@@ -268,7 +268,7 @@ private static boolean isSizeCompliant(int width, int height) {
 	 *
 	 * @param image the image to convert to WebP
 	 * @return converted image
-	 * @throws MediaException if an error occurs creating the temp file or
+	 * @throws MediaException if an error occurred creating the temp file, or
 	 * if the image size could not be reduced enough to meet Telegram's requirements
 	 */
 	private static File createWebpFile(ImmutableImage image) throws MediaException {
@@ -295,7 +295,7 @@ private static File createWebpFile(ImmutableImage image) throws MediaException {
 	}
 
 	/**
-	 * Creates a new temp file with desired extension.
+	 * Creates a new temp file with the desired extension.
 	 *
 	 * @param fileExtension the extension of the new file
 	 * @return a new temp file

src/main/java/com/github/stickerifier/stickerify/process/ProcessHelper.java

@@ -66,7 +66,7 @@ private static String readStream(InputStream stream) throws IOException {
 	}
 
 	/**
-	 * Reads the content of the input stream of the process.
+	 * Reads the content of the input stream.
 	 * If the input stream is empty, the content of the error stream is returned.
 	 *
 	 * @param process the process