Fix pathing in markdown documentation

internal/commands/document.go

@@ -181,6 +181,10 @@ func getDocumentation(path string, severity string, outputDirectory string) ([]D
 		}
 		relDir := filepath.Dir(relPath)
 
+		// Markdown specification notes that all pathing should be represented
+		// with a forward slash.
+		relDir = strings.ReplaceAll(relDir, string(os.PathSeparator), "/")
+
 		regoWithoutComments := getRegoWithoutComments(policy.Contents)
 
 		document := Document{

internal/rego/rego.go

@@ -185,6 +185,9 @@ func readFilesContents(filePaths []string) (map[string]string, error) {
 			return nil, fmt.Errorf("read file: %w", err)
 		}
 
+		// Many YAML parsers do not like rendering out CRLF when writing the YAML to disk.
+		// This causes ConstraintTemplates to be rendered with the line breaks as text,
+		// rather than the actual line break.
 		filesContents[filePath] = strings.ReplaceAll(string(data), "\r", "")
 	}