diff --git a/README.md b/README.md
index cc4ca57..b42b485 100644
--- a/README.md
+++ b/README.md
@@ -85,10 +85,10 @@ These YAML representations of definitions show the properties available for each
 Note that every Playbill component definition can define the following properties:
 
 ```yaml
-id: some-hypenated-id # default: slug-ified file name
-name: The Name of the Component # default: Name of the containing file
-description: A markdown-enabled description # default: Placeholder / empty
-categories: # default: No categories
+id: some-hypenated-id # defaults to a slugified version of the file name
+name: The Name of the Component # defaults to the file name
+description: A markdown-enabled description # defaults to a placeholder
+categories: # defaults to no categories
   - list
   - of
   - categories