diff --git a/src/main/java/de/kosit/validationtool/api/Check.java b/src/main/java/de/kosit/validationtool/api/Check.java
index 386fb8f..e24db00 100644
--- a/src/main/java/de/kosit/validationtool/api/Check.java
+++ b/src/main/java/de/kosit/validationtool/api/Check.java
@@ -29,8 +29,8 @@ import java.util.stream.Collectors;
 public interface Check {
 
     /**
-     * Checks an incoming xml {@link Input Inputs}. The result-{@link Document} is readonly. To change the this document
-     * you need to copy the nodes into an new {@link Document}.
+     * Checks an incoming xml {@link Input Inputs}. The result-{@link Document} is readonly. To change this document you
+     * need to copy the nodes into a new {@link Document}.
      *
      * @param input the resource / xml file to validate.
      * @return a result-{@link Document} (readonly)
@@ -51,7 +51,7 @@ public interface Check {
 
     /**
      * Checks an incoming xml files in batch mode. Processing is sequential. The result-{@link Document Documents} are
-     * readonly. To change the this document you need to copy them into new {@link Document Documents}.
+     * readonly. To change this document you need to copy them into new {@link Document Documents}.
      *
      *
      * @param input list of xml {@link Input Inputs}
diff --git a/src/main/java/de/kosit/validationtool/api/Configuration.java b/src/main/java/de/kosit/validationtool/api/Configuration.java
index 932fe67..0512235 100644
--- a/src/main/java/de/kosit/validationtool/api/Configuration.java
+++ b/src/main/java/de/kosit/validationtool/api/Configuration.java
@@ -103,7 +103,7 @@ public interface Configuration {
     }
 
     /**
-     * Loads an XML based scenario definition from the file with an specific repository / source location specified via
+     * Loads an XML based scenario definition from the file with a specific repository / source location specified via
      * URIs.
      *
      * @param scenarioDefinition the XML file with scenario definition
diff --git a/src/main/java/de/kosit/validationtool/cmd/CommandLineApplication.java b/src/main/java/de/kosit/validationtool/cmd/CommandLineApplication.java
index 5f6f1e6..fd84c4c 100644
--- a/src/main/java/de/kosit/validationtool/cmd/CommandLineApplication.java
+++ b/src/main/java/de/kosit/validationtool/cmd/CommandLineApplication.java
@@ -31,7 +31,7 @@ import static org.apache.commons.lang3.StringUtils.isNotEmpty;
  * Commandline interface of the validator. It parses the commandline args and hands over actual execution to
  * {@link Validator}.
  * <p>
- * This separated from {@link Validator} to configure the slf4j simple logging.
+ * This separated from {@link Validator} to configure the SLF4J simple logging.
  *
  * @author Andreas Penski
  */
diff --git a/src/main/java/de/kosit/validationtool/cmd/InternalCheck.java b/src/main/java/de/kosit/validationtool/cmd/InternalCheck.java
index 400b402..b0c068c 100644
--- a/src/main/java/de/kosit/validationtool/cmd/InternalCheck.java
+++ b/src/main/java/de/kosit/validationtool/cmd/InternalCheck.java
@@ -112,7 +112,7 @@ class InternalCheck extends DefaultCheck {
      * Prüft die Prüflinge und gibt Informationen über etwaige Assertions aus.
      *
      * @param input die Prüflinge
-     * @return false wenn es Assertion-Fehler gibt, sonst true
+     * @return false, wenn es Assertion-Fehler gibt, sonst true
      */
     @Override
     public Result checkInput(final Input input) {
diff --git a/src/main/java/de/kosit/validationtool/cmd/report/Grid.java b/src/main/java/de/kosit/validationtool/cmd/report/Grid.java
index adf0559..a15536d 100644
--- a/src/main/java/de/kosit/validationtool/cmd/report/Grid.java
+++ b/src/main/java/de/kosit/validationtool/cmd/report/Grid.java
@@ -30,7 +30,7 @@ import java.util.stream.Collectors;
 import java.util.stream.IntStream;
 
 /**
- * An text based grid for cli based programs.
+ * A text based grid for cli based programs.
  *
  * @author Andreas Penski
  */
diff --git a/src/main/java/de/kosit/validationtool/config/ConfigurationBuilder.java b/src/main/java/de/kosit/validationtool/config/ConfigurationBuilder.java
index 822694c..4fcceba 100644
--- a/src/main/java/de/kosit/validationtool/config/ConfigurationBuilder.java
+++ b/src/main/java/de/kosit/validationtool/config/ConfigurationBuilder.java
@@ -122,7 +122,7 @@ public class ConfigurationBuilder {
     }
 
     /**
-     * Adds a {@link Scenario} to this list of know scenarios. Note: order of calling this methods defines order of
+     * Adds a {@link Scenario} to this list of know scenarios. Note: order of calling these methods defines order of
      * scenarios when determining the target scenario for a given xml file.
      *
      * @param scenarioBuilder the {@link ScenarioBuilder} building the {@link Scenario}
diff --git a/src/main/java/de/kosit/validationtool/config/ScenarioBuilder.java b/src/main/java/de/kosit/validationtool/config/ScenarioBuilder.java
index b1e2836..6f1baa2 100644
--- a/src/main/java/de/kosit/validationtool/config/ScenarioBuilder.java
+++ b/src/main/java/de/kosit/validationtool/config/ScenarioBuilder.java
@@ -102,7 +102,7 @@ public class ScenarioBuilder implements Builder<Scenario> {
     }
 
     /**
-     * Add an xpath expression to match the scenario. You can leverage declared namespaces.
+     * Add a xpath expression to match the scenario. You can leverage declared namespaces.
      *
      * @param xpath the expression
      * @return this
@@ -136,7 +136,7 @@ public class ScenarioBuilder implements Builder<Scenario> {
     }
 
     /**
-     * Add an xpath expression to compute acceptance for the scenario. You can leverage declared namespaces.
+     * Add a xpath expression to compute acceptance for the scenario. You can leverage declared namespaces.
      *
      * @param acceptXpath the xpath expresison
      * @return this
diff --git a/src/main/java/de/kosit/validationtool/daemon/BaseHandler.java b/src/main/java/de/kosit/validationtool/daemon/BaseHandler.java
index 516b794..e764e43 100644
--- a/src/main/java/de/kosit/validationtool/daemon/BaseHandler.java
+++ b/src/main/java/de/kosit/validationtool/daemon/BaseHandler.java
@@ -23,7 +23,7 @@ import java.io.IOException;
 import java.io.OutputStream;
 
 /**
- * Simple base implemenation for http handlers. Doing I/O stuff.
+ * Simple base implementation for http handlers (doing I/O stuff).
  *
  * @author Andreas Penski
  */
diff --git a/src/main/java/de/kosit/validationtool/daemon/CheckHandler.java b/src/main/java/de/kosit/validationtool/daemon/CheckHandler.java
index 2ac9444..be98c08 100644
--- a/src/main/java/de/kosit/validationtool/daemon/CheckHandler.java
+++ b/src/main/java/de/kosit/validationtool/daemon/CheckHandler.java
@@ -36,8 +36,8 @@ import java.net.URI;
 import java.util.concurrent.atomic.AtomicLong;
 
 /**
- * Wir benötigen einen Handler, der zur Verarbeitung von HTTP-Anforderungen aufgerufen wird um hier die Verarbeitung des
- * POST Request zu realisieren.
+ * Wir benötigen einen Handler, der zur Verarbeitung von HTTP-Anforderungen aufgerufen wird, um hier die Verarbeitung
+ * des POST Request zu realisieren.
  */
 @Slf4j
 @RequiredArgsConstructor
@@ -52,8 +52,7 @@ class CheckHandler extends BaseHandler {
     /**
      * Methode, die eine gegebene Anforderung verarbeitet und eine entsprechende Antwort generiert
      *
-     * @param httpExchange kapselt eine empfangene HTTP-Anforderung und eine Antwort, die in einem Exchange generiert
-     *            werden soll.
+     * @param httpExchange kapselt eine empfangene HTTP-Anforderung und eine Antwort.
      */
     @Override
     public void handle(final HttpExchange httpExchange) throws IOException {
diff --git a/src/main/java/de/kosit/validationtool/impl/CollectingErrorEventHandler.java b/src/main/java/de/kosit/validationtool/impl/CollectingErrorEventHandler.java
index 95e6af7..afffbe8 100644
--- a/src/main/java/de/kosit/validationtool/impl/CollectingErrorEventHandler.java
+++ b/src/main/java/de/kosit/validationtool/impl/CollectingErrorEventHandler.java
@@ -95,7 +95,7 @@ public class CollectingErrorEventHandler implements ValidationEventHandler, Erro
     /**
      * Zeigt an, ob Validierungsfehler vorhanden sind.
      *
-     * @return true wenn mindestens ein Fehler vorhanden ist.
+     * @return true, wenn mindestens ein Fehler vorhanden ist.
      */
     public boolean hasErrors() {
         return hasEvents() && this.errors.stream().anyMatch(e -> e.getSeverityCode() != XMLSyntaxErrorSeverity.SEVERITY_WARNING);
@@ -104,7 +104,7 @@ public class CollectingErrorEventHandler implements ValidationEventHandler, Erro
     /**
      * Zeigt an, ob es Validierungs-Ereignisse gab.
      *
-     * @return true wenn mindestens ein Validierungsereignis aufgetreten ist
+     * @return true, wenn mindestens ein Validierungsereignis aufgetreten ist
      */
     public boolean hasEvents() {
         return !this.errors.isEmpty();
diff --git a/src/main/java/de/kosit/validationtool/impl/ContentRepository.java b/src/main/java/de/kosit/validationtool/impl/ContentRepository.java
index 6b9d963..351ca7b 100644
--- a/src/main/java/de/kosit/validationtool/impl/ContentRepository.java
+++ b/src/main/java/de/kosit/validationtool/impl/ContentRepository.java
@@ -203,7 +203,7 @@ public class ContentRepository {
     }
 
     /**
-     * Erzeugt einen [@link XPathExecutable} auf Basis der angegebenen Informationen.
+     * Erzeugt einen {@link XPathExecutable} auf Basis der angegebenen Informationen.
      *
      * @param expression der XPATH-Ausdruck
      * @param namespaces optionale Namespace-Mappings
diff --git a/src/main/java/de/kosit/validationtool/impl/DefaultCheck.java b/src/main/java/de/kosit/validationtool/impl/DefaultCheck.java
index 2efdc7d..3556723 100644
--- a/src/main/java/de/kosit/validationtool/impl/DefaultCheck.java
+++ b/src/main/java/de/kosit/validationtool/impl/DefaultCheck.java
@@ -51,7 +51,7 @@ import static de.kosit.validationtool.impl.DateFactory.createTimestamp;
 
 /**
  * The reference implementation for the validation process. After initialisation, instances are threadsafe and should be
- * reused since initializing saxon runtime objects is an rather heavyweight process.
+ * reused since initializing saxon runtime objects is a rather heavyweight process.
  *
  * @author Andreas Penski
  */
diff --git a/src/main/java/de/kosit/validationtool/impl/SchemaProvider.java b/src/main/java/de/kosit/validationtool/impl/SchemaProvider.java
index ddd0f62..5159b58 100644
--- a/src/main/java/de/kosit/validationtool/impl/SchemaProvider.java
+++ b/src/main/java/de/kosit/validationtool/impl/SchemaProvider.java
@@ -37,7 +37,8 @@ public class SchemaProvider {
     private static Schema reportInputSchema;
 
     /**
-     * Liefert das definierte Schema für die Validierung des [@link CreateReportInput}
+     * Liefert das definierte Schema für die Validierung des
+     * {@link de.kosit.validationtool.model.reportInput.CreateReportInput}
      *
      * @return ReportInput-Schema
      */
@@ -74,7 +75,7 @@ public class SchemaProvider {
     }
 
     /**
-     * Liefert das definiert Schema für die Szenario-Konfiguration
+     * Liefert das definierte Schema für die Szenario-Konfiguration
      *
      * @return Scenario-Schema
      */
diff --git a/src/main/java/de/kosit/validationtool/impl/input/SourceInput.java b/src/main/java/de/kosit/validationtool/impl/input/SourceInput.java
index 7866e97..0fd6f7c 100644
--- a/src/main/java/de/kosit/validationtool/impl/input/SourceInput.java
+++ b/src/main/java/de/kosit/validationtool/impl/input/SourceInput.java
@@ -33,7 +33,7 @@ import static org.apache.commons.lang3.StringUtils.defaultIfBlank;
 /**
  * A validator {@link de.kosit.validationtool.api.Input} based on a {@link Source}.
  * <p>
- * Note: The various implementations of {@link Source} varies wether the can be read twice or no. This implementation
+ * Note: The various implementations of {@link Source} varies whether they can be read twice or not. This implementation
  * tries to handle this with respect document identification (hashcode).
  * <p>
  * This class is known to work with:
diff --git a/src/main/java/de/kosit/validationtool/impl/model/BaseOutput.java b/src/main/java/de/kosit/validationtool/impl/model/BaseOutput.java
index 3773329..7e951bb 100644
--- a/src/main/java/de/kosit/validationtool/impl/model/BaseOutput.java
+++ b/src/main/java/de/kosit/validationtool/impl/model/BaseOutput.java
@@ -56,7 +56,7 @@ public abstract class BaseOutput {
     /**
      * Ermittelt, ob es bei der Validierung {@link FailedAssert}s gab.
      *
-     * @return true wenn mindestens ein {@link FailedAssert} vorhanden ist
+     * @return true, wenn mindestens ein {@link FailedAssert} vorhanden ist
      */
     public boolean hasFailedAsserts() {
         return !getFailedAsserts().isEmpty();
diff --git a/src/main/java/de/kosit/validationtool/impl/model/Result.java b/src/main/java/de/kosit/validationtool/impl/model/Result.java
index 22146f9..7db566b 100644
--- a/src/main/java/de/kosit/validationtool/impl/model/Result.java
+++ b/src/main/java/de/kosit/validationtool/impl/model/Result.java
@@ -60,7 +60,7 @@ public class Result<T, E> {
     /**
      * Zeigt an, ob das Ergebnis valide, also ohne Fehler ist.
      *
-     * @return true wenn erfolgreich
+     * @return true, wenn erfolgreich
      */
     public boolean isValid() {
         return object != null && errors.isEmpty();
@@ -69,7 +69,7 @@ public class Result<T, E> {
     /**
      * Zeigt an, ob das Ergebnis nicht valide ist, als entsprechend Fehler gesammelt wurden.
      *
-     * @return true wenn erfolgreich wenn Fehler vorhanden sind.
+     * @return true, wenn erfolgreich, false, wenn Fehler vorhanden sind.
      */
     public boolean isInvalid() {
         return !isValid();
diff --git a/src/main/java/de/kosit/validationtool/impl/tasks/CreateReportAction.java b/src/main/java/de/kosit/validationtool/impl/tasks/CreateReportAction.java
index 9be4622..bbdfd56 100644
--- a/src/main/java/de/kosit/validationtool/impl/tasks/CreateReportAction.java
+++ b/src/main/java/de/kosit/validationtool/impl/tasks/CreateReportAction.java
@@ -52,7 +52,7 @@ import java.util.stream.Collectors;
 
 /**
  * Erzeugt den Report auf Basis der gesammelten Informationen über den Prüfling. Sollte kein Szenario identifiziert
- * worden sein, so wird ein das Fallback-Szenario verwend und ein default report} erzeugt.
+ * worden sein, so wird ein das Fallback-Szenario verwendet und ein default report erzeugt.
  *
  * @author Andreas Penski
  */
@@ -122,7 +122,7 @@ public class CreateReportAction implements CheckAction {
 
     /**
      * Wrapper to fix some inconsistencies between sax and saxon. Saxon tries to set some properties which has no effect
-     * on {@link JAXBSource}'s XMLReader, but it throws exceptions on unknown properties. This just drops this
+     * on {@link JAXBSource}'s XMLReader, but it throws exceptions on unknown properties. This just drops these
      * exceptions.
      */
     private static class ReaderWrapper implements XMLReader {
diff --git a/src/main/java/de/kosit/validationtool/impl/tasks/DocumentParseAction.java b/src/main/java/de/kosit/validationtool/impl/tasks/DocumentParseAction.java
index 63ec08d..37a427b 100644
--- a/src/main/java/de/kosit/validationtool/impl/tasks/DocumentParseAction.java
+++ b/src/main/java/de/kosit/validationtool/impl/tasks/DocumentParseAction.java
@@ -45,7 +45,7 @@ public class DocumentParseAction implements CheckAction {
     private final Processor processor;
 
     /**
-     * Parsed und überprüft ein übergebenes Dokument darauf ob es well-formed ist. Dies stellt den ersten
+     * Parsed und überprüft ein übergebenes Dokument darauf, ob es well-formed ist. Dies stellt den ersten
      * Verarbeitungsschritt des Prüf-Tools dar. Diese Funktion verzichtet explizit auf die Validierung gegenüber einem
      * Schema.
      *
diff --git a/src/main/java/de/kosit/validationtool/impl/tasks/SchemaValidationAction.java b/src/main/java/de/kosit/validationtool/impl/tasks/SchemaValidationAction.java
index a454221..d5116cf 100644
--- a/src/main/java/de/kosit/validationtool/impl/tasks/SchemaValidationAction.java
+++ b/src/main/java/de/kosit/validationtool/impl/tasks/SchemaValidationAction.java
@@ -84,7 +84,7 @@ public class SchemaValidationAction implements CheckAction {
 
         @Override
         public void close() {
-            // nothing do do
+            // nothing to do
         }
 
         @Override
diff --git a/src/main/java/de/kosit/validationtool/impl/xml/ClassPathResourceResolver.java b/src/main/java/de/kosit/validationtool/impl/xml/ClassPathResourceResolver.java
index 3af9b06..30f1ca6 100644
--- a/src/main/java/de/kosit/validationtool/impl/xml/ClassPathResourceResolver.java
+++ b/src/main/java/de/kosit/validationtool/impl/xml/ClassPathResourceResolver.java
@@ -63,7 +63,7 @@ public class ClassPathResourceResolver implements LSResourceResolver {
         private String stringData;
 
         /**
-         * Instantiierung einer neue Instanz.
+         * Instantiierung einer neuen Instanz.
          *
          * @param publicId die publicId
          * @param systemId die systemId
diff --git a/src/main/java/de/kosit/validationtool/impl/xml/StrictLocalResolvingStrategy.java b/src/main/java/de/kosit/validationtool/impl/xml/StrictLocalResolvingStrategy.java
index 0a57914..f79bb89 100644
--- a/src/main/java/de/kosit/validationtool/impl/xml/StrictLocalResolvingStrategy.java
+++ b/src/main/java/de/kosit/validationtool/impl/xml/StrictLocalResolvingStrategy.java
@@ -25,8 +25,8 @@ import javax.xml.validation.Validator;
 import java.net.URI;
 
 /**
- * This is a slightly more open implementation that allows resolving artifacts from local filesystems. Your are not
- * bound to a specific 'repository'. But your validation artifacts (schema, xsl, etc.) must be available locally. This
+ * This is a slightly more open implementation that allows resolving artifacts from local filesystems. You are not bound
+ * to a specific 'repository'. But your validation artifacts (schema, xsl, etc.) must be available locally. This
  * implementation does not allow loading from http sources
  *
  * @author Andreas Penski