Contributing

Contributor setup, architecture notes, and design records for Restish v2.

Contributor docs are separated from the end-user guides on purpose. Start here if you want to build Restish itself, work on the docs site, or understand the core architecture before changing behavior.

Path

Documentation -> Contributing

Start Here

  • Development Setup for the local toolchain and common commands.
  • Design Records for the subsystem-level architecture documents in the repository’s docs/design/ directory.
  • Release Packaging for release artifacts, Homebrew, GitHub releases, Go install, plugin binaries, and changelog checks.
  • Docs Maintenance for doc checklists, validation, and migration status.

Good Next Steps

  • Read the CLI architecture record before changing shared command behavior.
  • Check subsystem design docs before editing auth, spec loading, output, or plugin runtime code.
  • Keep public docs focused on user workflows, then link deeper design notes when architecture context matters.

Development Setup

Build, test, run, and validate Restish and the documentation site from a local checkout.

Design Records

Maintainer-oriented records that preserve Restish v2 design intent, invariants, and user-doc triggers.

Docs Maintenance

Contributor checklist for user-facing documentation, validation steps, live examples, and migration audits.

Release Packaging

Maintainer checklist for Homebrew, GitHub releases, Go install, plugin binaries, versions, and changelog updates.