Skip to content

docs: packaging workspace tooling and registry-hosting chapter#84

Open
MattDHill wants to merge 2 commits into
masterfrom
docs/packaging-workspace-and-registry-hosting
Open

docs: packaging workspace tooling and registry-hosting chapter#84
MattDHill wants to merge 2 commits into
masterfrom
docs/packaging-workspace-and-registry-hosting

Conversation

@MattDHill
Copy link
Copy Markdown
Member

Omnibus update to the docs site, spanning three themes.

Packaging workspace + AI-agent tooling

  • New Development Workflow page (workflow.md) — the disciplines that apply to every packaging task, added to the sidebar and the guide's Getting Started list.
  • New packaging/AGENTS.md — always-on agent context for a StartOS packaging workspace (layout, local-first guide navigation, golden rules).
  • New package-template/ scaffold — a barebones start-cli s9pk init-package clone: one daemon, no interface, no health check, runtime i18n trimmed to what's used, and example-* placeholder ids that signal "rename me." Replaces the old SAMPLE-CLAUDE.txt.
  • Environment Setup reworked around start-cli s9pk init-workspace; README.md, quick-start.md, and project-structure.md updated to the new workspace flow.

Hosting a Registry (new chapter)

  • Overview, Setup, and Administration pages for running the startos-registry service.
  • publishing.md now links to the chapter instead of inlining the steps.
  • Added the registry section to start-os/cli-reference.md, which Administration links to.

Misc fixes

  • versions.md: guidance on sizing release notes to the change (one line vs. bullets vs. headered sections).
  • start-os: tightened initial-setup.md and trust-ca.md wording.

MattDHill and others added 2 commits May 21, 2026 08:37
Packaging guide:
- New Development Workflow page covering the disciplines that apply to every task.
- New packaging AGENTS.md (always-on agent context for a packaging workspace) and a
  barebones package-template/ scaffold (one daemon, no interface, example-* placeholder
  ids); drop the old SAMPLE-CLAUDE.txt.
- Rework Environment Setup around `start-cli s9pk init-workspace`; update
  README/quick-start/project-structure to the new workspace flow.
- versions.md: guidance on sizing release notes to the change.

Hosting a Registry (new chapter):
- Overview, Setup, and Administration pages for running the startos-registry service.
- publishing.md links to the chapter; add the registry section to the start-os
  cli-reference that Administration links to.

start-os guide:
- Tighten initial-setup and trust-ca wording.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Webhooks were dropped from the registry, so remove the corresponding
docs: the Administration Webhooks section, the start-cli registry
webhook command reference, and the passing references in the hosting
chapter overview and publishing page.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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.

1 participant