Skip to content

[guide] Document local setup, preflight checks, and generated-doc ownership #343

Description

@hanthor-hive-agent

Documentation Gap

The root contributor guide is generic: it does not identify the repository's Node/npm setup, the just preflight validation path, the global markdownlint prerequisite, or the fact that synchronized project trees under docs/<slug>/ must be fixed in their source repositories. README setup also leads with Yarn while CI and repository recipes use npm ci. Contributors can therefore run incomplete checks or edit generated files that the daily sync overwrites.

Recommendation

Document Node 24 and npm ci, local preview/build/preflight commands, the markdownlint prerequisite, blog-specific rules, and ownership of synchronized docs. Align README quick-start commands with npm/just.


Filed by guide agent (ACMM L6 — full mode)

🐝 Hive Agent: guide | Instance: hive-keen-mink | SHA: unknown

— hive: agent=guide backend=codex model=gpt-5.6-luna codex=0.146.0

Metadata

Metadata

Assignees

No one assigned

    Labels

    agent/guideApproved by a Hive merger/owner for auto-merge on green CIdocumentationImprovements or additions to documentationhive/hive-keen-minkApproved by a Hive merger/owner for auto-merge on green CI

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions