villebro opened a new pull request, #175: URL: https://github.com/apache/superset-kubernetes-operator/pull/175
## Summary Introduce [rumdl](https://rumdl.dev/) — a fast, self-contained Rust Markdown linter/formatter — to enforce a single deterministic format across the README, the docs site, and other Markdown files. Until now Markdown had no linter, so formatting drifted: inconsistent heading spacing and list indentation, and mixed prose conventions (some docs used single-line paragraphs, others hard-wrapped at ~80 columns). rumdl gives one canonical, machine-enforced format wired into CI, a local pre-commit hook, and Renovate for version bumps. It ships as a pinned binary, so it adds no Python or Node runtime dependency. Prose is normalized to one line per paragraph (no hard wrapping). Because Markdown collapses newlines within a paragraph, rendered output is unchanged — this is purely a source/version-control choice that keeps diffs clean (editing a sentence never reflows the surrounding lines). ## Details - **Tooling** (`Makefile`): `RUMDL_VERSION` pin (tracked by the existing github-releases Renovate custom manager); `make rumdl` downloads and checksum-verifies the release binary into `bin/`; `make lint-md` (check) and `make format-md` (auto-fix). - **Config**: rules live in the repo-root `.rumdl.toml` (`gfm` flavor, for the GitHub-rendered README and other top-level files) with `MD013` reflow in `normalize` mode for single-line prose. `docs/.rumdl.toml` `extends` it and overrides the flavor to `mkdocs` so admonitions/content tabs are understood on the docs site. The generated `docs/reference/api-reference.md` and the `.github` templates are excluded. - **CI**: a `Lint Markdown` step in the lint job fails if any file isn't in canonical form. - **Pre-commit** (`.githooks/pre-commit`): reformats staged Markdown in a single `rumdl` pass and aborts the commit if anything changed (or if unfixable issues remain), so the author reviews and re-stages — nothing is silently amended. - **Generator fix** (`scripts/render-make-commands.sh`): emits a trailing blank line so its generated table stays rumdl-clean. - **Reformat**: all existing Markdown converted to the canonical form (the bulk of the diff). - **Bycatch**: corrects a stale `kubectl get supersets` example in `docs/index.md` (`VERSION` → `TAG`, and adds the missing `LIFECYCLE` column) to match the CRD's printer columns. Verification: `make lint-md` is clean and idempotent, and `mkdocs build --strict` passes on the reformatted docs. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
