Skip to content

docs: add Lint repository CI check step to Making changes - #583

Merged
castrojo merged 1 commit into
mainfrom
docs/contributing-lint-checks
Sep 24, 2026
Merged

castrojo merged 1 commit into
mainfrom
docs/contributing-lint-checks

Conversation

@mrbobbytables

Copy link
Copy Markdown
Member

Summary

Adds a step to CONTRIBUTING.md's "Making changes" section documenting the
"Lint repository" CI job (check:format, check:spelling,
check:markdown), which was previously unmentioned anywhere in the repo's
docs. Without it, a contributor could follow every documented step and
still fail CI on their first PR due to an undocumented required check.

Closes #569

Verification

  • npm run check:format passes on the updated file (ran npm run fix:format to apply Prettier's formatting to the new list items).
  • npm run check:spelling — 0 issues.
  • Manually confirmed the three lint scripts and their fix paths
    (fix:format, .cspell.yml, .markdownlint.yaml) against
    package.json and .github/workflows/ci.yml.

Checklist

  • Content speaks to end users (see CONTRIBUTING.md) — contributor-facing doc fix
  • Commits are DCO-signed (git commit -s)
  • Site builds without new warnings (docs-only change)

— hive: backend=copilot model=claude-sonnet-5

🐝 Hive Agent: contributor | SHA: 3ecdfa7

CONTRIBUTING.md's 'Making changes' section told contributors to run
test:unit and build but never mentioned the 'Lint repository' CI job
(check:format, check:spelling, check:markdown), so a first-time
contributor could pass every documented step and still fail CI on
lint. Add a step covering npm run check and how to fix each failure
class.

Hive-Run: #569
Hive-Plan: docs-contributing-lint-checks
Hive-Spec: contributing-guide#making-changes-lint-step
Signed-off-by: mrbobbytables <mrbobbytables@users.noreply.github.com>
@castrojo
castrojo added this pull request to the merge queue Sep 24, 2026
Merged via the queue into main with commit c38f0a6 Sep 24, 2026
5 checks passed
@mrbobbytables
mrbobbytables deleted the docs/contributing-lint-checks branch September 25, 2026 17:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[guide] CONTRIBUTING.md 'Making changes' omits the Lint repository CI checks (check:format, check:spelling, check:markdown)

2 participants