diff --git a/CHANGELOG.md b/CHANGELOG.md
index 37f2f48..e4bd7d0 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,7 @@ with old releases.
 - BREAKING
   - Switch configuration files to YAML
   - Enable multi location configuration files [#14](https://github.com/xoxys/ansible-later/issues/14)
+  - ID's used in standards have to be unique (or not set)
 
 - FEATURE
   - Add optional JSON logging [#13](https://github.com/xoxys/ansible-later/issues/13)
diff --git a/README.md b/README.md
index accbcb4..30b7f4a 100644
--- a/README.md
+++ b/README.md
@@ -242,7 +242,9 @@ Create a file called standards.py (this can import other modules)
 from ansiblelater include Standard, Result
 
 tasks_are_uniquely_named = Standard(dict(
+    # ID's are optional but if you use ID's they have to be unique
     id="ANSIBLE0003",
+    # Short description of the standard goal
     name="Tasks and handlers must be uniquely named within a single file",
     check=check_unique_named_task,
     version="0.1",