Improved docs

Author: litetex

extractor/src/main/java/org/schabi/newpipe/extractor/comments/CommentsInfoItemExtractor.java

@@ -12,7 +12,7 @@
 public interface CommentsInfoItemExtractor extends InfoItemExtractor {
 
     /**
-     * Return the like count of the comment, or -1 if it's unavailable<br/>
+     * Return the (approximate) like count of the comment, or -1 if it's unavailable<br/>
      * NOTE: Currently only implemented for YT {@link YoutubeCommentsInfoItemExtractor#getLikeCount()}
      * with limitations
      *

extractor/src/main/java/org/schabi/newpipe/extractor/services/youtube/extractors/YoutubeCommentsInfoItemExtractor.java

@@ -73,10 +73,18 @@ public DateWrapper getUploadDate() throws ParsingException {
 
     /**
      * @implNote The method is parsing internally a localized string.<br/>
-     * This will fail for other languages than English.
-     * However as long as the Extractor only uses "en-GB"
-     * (as seen in {@link org.schabi.newpipe.extractor.services.youtube.YoutubeService#SUPPORTED_LANGUAGES})
-     * everything will work fine.<br/>
+     * <ul>
+     *     <li>
+     *         More than >1k likes will result in an inaccurate number
+     *     </li>
+     *     <li>
+     *         This will fail for other languages than English.
+     *         However as long as the Extractor only uses "en-GB"
+     *         (as seen in {@link org.schabi.newpipe.extractor.services.youtube.YoutubeService#SUPPORTED_LANGUAGES})
+     *         everything will work fine.
+     *      </li>
+     * </ul>
+     * <br/>
      * Consider using {@link #getTextualVoteCount()}
      */
     @Override