Function processCommand

app/cli/documentation/generate.go:96–148

processCommand processes the command documentation, filtering out unnecessary sections and formatting headers.

(content string, depth int)

// processCommand processes the command documentation, filtering out unnecessary sections and formatting headers.
func processCommand(content string, depth int) string {
	lines := strings.Split(content, "\n")
	// nolint: prealloc
	var filtered []string
	inSeeAlso := false

	for i, line := range lines {
		trimmed := strings.TrimSpace(line)

		// Skip "SEE ALSO" section and everything after
		if strings.Contains(trimmed, "### SEE ALSO") {
			inSeeAlso = true
			continue
		}
		if inSeeAlso {
			continue
		}

		// Strip all leading '#' characters and spaces from any header line
		cleanLine := strings.TrimLeft(trimmed, "# ")

		// Detect underline-style headers (--- or ===)
		if i > 0 && isUnderlineHeader(line) {
			// Remove previous line (header text)
			if len(filtered) > 0 {
				prev := filtered[len(filtered)-1]
				filtered = filtered[:len(filtered)-1]
				// Add heading with dynamic depth + 1 (subsection)
				filtered = append(filtered, fmt.Sprintf("%s %s",
					strings.Repeat("#", depth+3), // depth+3 for sub-sections
					prev))
			}
			continue
		}

		// For the first line (command title), apply heading with dynamic depth
		if i == 0 && cleanLine != "" {
			filtered = append(filtered, fmt.Sprintf("%s %s",
				strings.Repeat("#", depth+2), // depth+2 to start from H2 for root
				cleanLine))
			continue
		}

		// Replace $HOME environment variable references
		if home := os.Getenv("HOME"); home != "" {
			cleanLine = strings.ReplaceAll(cleanLine, home, "$HOME")
		}

		filtered = append(filtered, cleanLine)
	}

	return strings.Join(filtered, "\n") + "\n\n"
}

// isUnderlineHeader checks if a line is an underline-style header (--- or ===).
func isUnderlineHeader(line string) bool {