diff --git a/src/main/java/com/moandjiezana/toml/ValueParser.java b/src/main/java/com/moandjiezana/toml/ValueParser.java
index 521b93e..af2377c 100644
--- a/src/main/java/com/moandjiezana/toml/ValueParser.java
+++ b/src/main/java/com/moandjiezana/toml/ValueParser.java
@@ -2,6 +2,13 @@ package com.moandjiezana.toml;
 
 interface ValueParser {
 
+  /**
+   * @param s must already have been trimmed
+   */
   boolean canParse(String s);
+  
+  /**
+   * @param s must already have been validated by {@link #canParse(String)}
+   */
   Object parse(String s);
 }