Note about docs in macros

src/spectator/dsl.cr

@@ -2,6 +2,10 @@ require "./dsl/*"
 
 module Spectator
   # Namespace containing methods representing the spec domain specific language.
+  #
+  # Note: Documentation inside macros is kept to a minimuum to reduce generated code.
+  # This also helps keep error traces small.
+  # Documentation only useful for debugging is included in generated code.
   module DSL
   end
 end