diff --git a/workflow-basics.Rmd b/workflow-basics.Rmd
index b2fda3f..83190c1 100644
--- a/workflow-basics.Rmd
+++ b/workflow-basics.Rmd
@@ -51,6 +51,14 @@ Instead, use RStudio's keyboard shortcut: Alt + - (the minus sign).
 Notice that RStudio automagically surrounds `<-` with spaces, which is a good code formatting practice.
 Code is miserable to read on a good day, so giveyoureyesabreak and use spaces.
 
+## Comments
+
+R will ignore any text after `#`.
+This allows to you to write **comments**, text that is ignored by R but read by other humans.
+We'll sometimes include comments in examples explaining what's happening with the code.
+
+TODO: add more info
+
 ## What's in a name?
 
 Object names must start with a letter, and can only contain letters, numbers, `_` and `.`.