Add javadoc

Author: glibas

src/main/java/com/assertthat/selenium_shutterbug/core/Snapshot.java

@@ -85,6 +85,8 @@ public T withThumbnail(String path, String name, double scale) {
      * @param path to save thumbnail image to
      * @param name of the resulting image
      * @param scale to apply
+     * @param cropWidth e.g. 0.2 will leave 20% of the initial width
+     * @param cropHeight e.g. 0.1 will leave 10% of the initial width
      * @return instance of type Snapshot
      */
     public T withCroppedThumbnail(String path, String name, double scale,  double cropWidth, double cropHeight) {
@@ -102,6 +104,8 @@ public T withCroppedThumbnail(String path, String name, double scale,  double cr
      * Will save different thumbnails depends on when it was called in the chain.
      *
      * @param scale to apply
+     * @param cropWidth e.g. 0.2 will leave 20% of the initial width
+     * @param cropHeight e.g. 0.1 will leave 10% of the initial width
      * @return instance of type Snapshot
      */
     public T withCroppedThumbnail(double scale, double cropWidth, double cropHeight) {

src/main/java/com/assertthat/selenium_shutterbug/utils/web/Browser.java

@@ -96,7 +96,9 @@ public BufferedImage takeScreenshot() {
 
     /**Using different screenshot strategy dependently on driver:
      * for  chrome - chrome command will be used
-     * for others - their default screenshot methods*/
+     * for others - their default screenshot methods
+     * @return BufferedImage resulting image
+     * */
     public BufferedImage takeScreenshotEntirePage() {
         if (driver instanceof EventFiringWebDriver) {
             driver = ((EventFiringWebDriver) this.driver).getWrappedDriver();