diff --git a/operation.go b/operation.go
index 3664fd9af..fa74384dc 100644
--- a/operation.go
+++ b/operation.go
@@ -161,7 +161,7 @@ func (operation *Operation) ParseComment(comment string, astFile *ast.File) erro
 	return nil
 }
 
-// ParseCodeSample godoc.
+// ParseCodeSample parse code sample.
 func (operation *Operation) ParseCodeSample(attribute, _, lineRemainder string) error {
 	if lineRemainder == "file" {
 		data, err := getCodeExampleForSummary(operation.Summary, operation.codeExampleFilesDir)
@@ -186,12 +186,12 @@ func (operation *Operation) ParseCodeSample(attribute, _, lineRemainder string)
 	return operation.ParseMetadata(attribute, strings.ToLower(attribute), lineRemainder)
 }
 
-// ParseDescriptionComment godoc.
+// ParseStateComment parse state comment.
 func (operation *Operation) ParseStateComment(lineRemainder string) {
 	operation.State = lineRemainder
 }
 
-// ParseDescriptionComment godoc.
+// ParseDescriptionComment parse description comment.
 func (operation *Operation) ParseDescriptionComment(lineRemainder string) {
 	if operation.Description == "" {
 		operation.Description = lineRemainder
@@ -202,7 +202,7 @@ func (operation *Operation) ParseDescriptionComment(lineRemainder string) {
 	operation.Description += "\n" + lineRemainder
 }
 
-// ParseMetadata godoc.
+// ParseMetadata parse metadata.
 func (operation *Operation) ParseMetadata(attribute, lowerAttribute, lineRemainder string) error {
 	// parsing specific meta data extensions
 	if strings.HasPrefix(lowerAttribute, "@x-") {