diff --git a/magefile.go b/magefile.go
index 7e009e91a..1a0ecb0c9 100644
--- a/magefile.go
+++ b/magefile.go
@@ -797,9 +797,11 @@ func (Dev) MakeEvent(name, module string) error {
 	eventName := strings.ReplaceAll(strcase.ToDelimited(name, '.'), ".event", "")
 
 	newEventCode := `
+// ` + name + ` represents a ` + name + ` event
 type ` + name + ` struct {
 }
 
+// TopicName defines the name for ` + name + `
 func (t *` + name + `) TopicName() string {
 	return "` + eventName + `"
 }
@@ -818,13 +820,16 @@ func (Dev) MakeListener(name, event, module string) error {
 	name = strcase.ToCamel(name)
 	listenerName := strcase.ToDelimited(name, '.')
 	listenerCode := `
+// ` + name + `  represents a listener
 type ` + name + ` struct {
 }
 
+// Name defines the name for the ` + name + ` listener
 func (s *` + name + `) Name() string {
 	return "` + listenerName + `"
 }
 
+// Hanlde is executed when the event ` + name + ` listens on is fired
 func (s *` + name + `) Handle(payload message.Payload) (err error) {
 	event := &` + event + `{}
 	err = json.Unmarshal(payload, event)