Problem
pnpm check:docs currently depends on a Unix-style pipeline in format:docs:check:
git ls-files 'docs/**/*.md' 'docs/**/*.mdx' 'README.md' | xargs oxfmt --check
That works in bash/Git Bash, but fails in native Windows PowerShell because xargs is not available by default.
Why It Matters
- Contributors on native Windows hit a tooling failure before any actual docs formatting is checked.
- This makes the repository appear less Windows-compatible than it really is.
- The repo already supports Windows in other areas, so shell-only docs tooling is an avoidable paper cut.
Repro
- Open native PowerShell on Windows.
- Run
pnpm check:docs from the repository root.
- Observe
xargs is not recognized as an internal or external command.
Suggested Direction
Replace the shell pipeline with a shell-agnostic approach, for example:
- a small Node script that expands tracked docs files and invokes
oxfmt
- or a package command that accepts file lists without requiring
xargs
Acceptance Criteria
pnpm check:docs succeeds in native PowerShell on Windows.
- The docs formatting check still runs correctly in bash/Linux/macOS.
- The contributor workflow does not require Git Bash just to validate docs formatting.
Problem
pnpm check:docscurrently depends on a Unix-style pipeline informat:docs:check:That works in bash/Git Bash, but fails in native Windows PowerShell because
xargsis not available by default.Why It Matters
Repro
pnpm check:docsfrom the repository root.xargs is not recognized as an internal or external command.Suggested Direction
Replace the shell pipeline with a shell-agnostic approach, for example:
oxfmtxargsAcceptance Criteria
pnpm check:docssucceeds in native PowerShell on Windows.