diff --git a/src/main/java/io/github/swagger2markup/Swagger2MarkupConverter.java b/src/main/java/io/github/swagger2markup/Swagger2MarkupConverter.java
index <HASH>..<HASH> 100644
--- a/src/main/java/io/github/swagger2markup/Swagger2MarkupConverter.java
+++ b/src/main/java/io/github/swagger2markup/Swagger2MarkupConverter.java
@@ -177,7 +177,7 @@ public class Swagger2MarkupConverter {
     }
 
     /**
-     * Converts the Swagger specification into the {@code outputPath} which can be either a directory or a file path.
+     * Converts the Swagger specification into the {@code outputPath} which can be either a directory (e.g /tmp) or a file without extension (e.g /tmp/swagger).
      * Internally the method invokes either {@code toFolder} or {@code toFile}.
      *
      * @param outputPath the output path
Updated javadoc of toPath