Tuned some of the responses in rules after reviewing report.

functions/openapi/examples.go

@@ -474,8 +474,8 @@ func analyzeExample(nameNodeValue string, mediaTypeNode *yaml.Node, basePath str
 				// check if the example contains a summary
 				_, summaryNode := utils.FindKeyNode("summary", []*yaml.Node{multiExampleNode})
 				if summaryNode == nil {
-					z := model.BuildFunctionResultString(fmt.Sprintf("Example `%s` missing a `summary`, "+
-						"examples need explaining", exampleName))
+					z := model.BuildFunctionResultString(fmt.Sprintf("Example `%s` missing a `summary` "+
+						"- examples need explaining", exampleName))
 					z.StartNode = esValue
 					z.EndNode = valueNode
 					z.Path = nodePath
@@ -486,7 +486,7 @@ func analyzeExample(nameNodeValue string, mediaTypeNode *yaml.Node, basePath str
 				// can`t both have a value and an external value set!
 				if valueNode != nil && externalValueNode != nil {
 					z := model.BuildFunctionResultString(fmt.Sprintf("Example `%s` is not valid: cannot use"+
-						" both `value` and `externalValue`, choose one or the other",
+						" both `value` and `externalValue` - choose one or the other",
 						exampleName))
 					z.StartNode = esValue
 					z.EndNode = valueNode

functions/openapi/operation_descriptions.go

@@ -84,7 +84,7 @@ func (od OperationDescription) RunRule(nodes []*yaml.Node, context model.RuleFun
 				descKey, descNode = utils.FindKeyNode("description", requestBodyNode.Content)
 
 				if descNode == nil {
-					res := createDescriptionResult(fmt.Sprintf("Operation requestBody `%s` at path `%s` "+
+					res := createDescriptionResult(fmt.Sprintf("Operation `requestBody` for method `%s` at path `%s` "+
 						"is missing a description", opMethod, opPath),
 						utils.BuildPath(basePath, []string{"requestBody"}), requestBodyKey, requestBodyNode)
 					res.Rule = context.Rule
@@ -95,7 +95,7 @@ func (od OperationDescription) RunRule(nodes []*yaml.Node, context model.RuleFun
 					words := strings.Split(descNode.Value, " ")
 					if len(words) < minWords {
 
-						res := createDescriptionResult(fmt.Sprintf("Operation `%s` requestBody description "+
+						res := createDescriptionResult(fmt.Sprintf("Operation `requestBody` for method `%s` description "+
 							"at path `%s` must be at least %d words long, (%d is not enough)", opMethod, opPath,
 							minWords, len(words)), basePath, descKey, descNode)
 						res.Rule = context.Rule

functions/openapi/paths_kebab_case.go

@@ -40,6 +40,9 @@ func (vp PathsKebabCase) RunRule(nodes []*yaml.Node, context model.RuleFunctionC
 				continue
 			}
 			path := fmt.Sprintf("$.paths.%s", opPath)
+			if opPath == "/" {
+				continue
+			}
 			notKebab, segments := checkPathCase(opPath)
 			if notKebab {
 				results = append(results, model.RuleFunctionResult{

functions/openapi/success_response.go

@@ -84,7 +84,7 @@ func (sr SuccessResponse) RunRule(nodes []*yaml.Node, context model.RuleFunction
 							}
 
 							results = append(results, model.RuleFunctionResult{
-								Message:   fmt.Sprintf("Operation `%s` must define at least a single 2xx or 3xx response", name),
+								Message:   fmt.Sprintf("Operation `%s` must define at least a single `2xx` or `3xx` response", name),
 								StartNode: fieldNode,
 								EndNode:   endNode,
 								Path:      fmt.Sprintf("$.paths.%s.%s.%s", currentPath, currentVerb, context.RuleAction.Field),

rulesets/ruleset_functions.go

@@ -1180,7 +1180,7 @@ func GetPathsKebabCaseRule() *model.Rule {
 		Recommended:  true,
 		RuleCategory: model.RuleCategories[model.CategoryOperations],
 		Type:         validation,
-		Severity:     err,
+		Severity:     warn,
 		Then: model.RuleAction{
 			Function: "pathsKebabCase",
 		},