diff --git a/README.md b/README.md
index 9453cf4..7639d6f 100644
--- a/README.md
+++ b/README.md
@@ -23,12 +23,12 @@ The `pycmx` package provides a basic interface for parsing a CMX 3600 EDL and it
 >>> edl = pycmx.parse_cmx3600("tests/edls/TEST.edl")
 >>> edl.title
 'DC7 R1_v8.2'
->>> events = list( edl.events )
+>>> events = list( edl.events ) # the event list is a generator
 >>> len(events)
 120
->>> events[43].number
+>>> events[43].number 
 '044'
->>> events[43].edits[0].source_in
+>>> events[43].edits[0].source_in # events contain multiple edits to preserve A/B dissolves and key backgrounds
 '00:00:00:00'
 >>> events[43].edits[0].transition.cut
 True