Skip to content

docs: prepare documentation for public open-source use - #32

Merged
0then0 merged 2 commits into
mainfrom
docs/public-release
Nov 10, 2026
Merged

0then0 merged 2 commits into
mainfrom
docs/public-release

Conversation

@0then0

@0then0 0then0 commented Nov 10, 2026

Copy link
Copy Markdown
Owner

Rewrites the documentation for people meeting the project for the first time, and removes development-stage leftovers.

Documentation

  • Guides describe current behavior instead of development history ("this stage", "no longer", "revised script", rc.1 notes, local ETIMEDOUT diagnostics, migration-specific notes outside release notes).
  • Docker Compose and Netlify guides restructured into numbered steps; hardcoded 0.2.0 artifact names replaced with <version>.
  • Webhooks: full payload example and a signature verification snippet matching services/deliveries.ts.
  • Architecture: repository layout and technology overview.
  • New docs/releasing.md for maintainers; packaging and release steps moved out of the installation guide.
  • CONTRIBUTING: corrected the claim that the maintainer pushes directly to main (the ruleset requires PRs).
  • SECURITY and dependency maintenance: removed one-time repository setup notes.
  • CHANGELOG Unreleased updated with the changes since 0.2.0.
  • README documentation index grouped by audience.

Code and config (no behavior change)

  • OpenAPI description pointed to README for MCP; now docs/api.md.
  • Removed expired minimumReleaseAgeExclude entries (all versions are months old; frozen install unchanged).
  • Removed the acceptance runner's union with files that were uncommitted during review (they are tracked now).
  • Reworded comments that called after() new; added package metadata.

Checked: relative links and anchors in all Markdown files, format:check, lint, knip, typecheck, unit tests, test:deployment.

Describe current behavior instead of development history, restructure the
deployment guides into steps, add a webhook verification example, a
repository layout and a maintainer releasing guide, and fix outdated
references and anchors.
Drop expired minimumReleaseAgeExclude entries and the acceptance runner's
list of formerly uncommitted files, reword comments that referred to new
behavior, and add description, license and repository fields.
@netlify

netlify Bot commented Nov 10, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for form-forge-0then0 canceled.

Name Link
🔨 Latest commit 578dbe6
🔍 Latest deploy log https://app.netlify.com/projects/form-forge-0then0/deploys/6af3963c1e40c7eb0774c86e

@0then0
0then0 merged commit dc192b2 into main Nov 10, 2026
7 checks passed
@0then0
0then0 deleted the docs/public-release branch November 10, 2026 22:13
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