Skip to content

chore: record the CONTRIBUTING standardization - #91

Merged
retr0h merged 1 commit into
mainfrom
chore/record-contributing-standardization
Aug 16, 2026
Merged

chore: record the CONTRIBUTING standardization#91
retr0h merged 1 commit into
mainfrom
chore/record-contributing-standardization

Conversation

@retr0h

@retr0h retr0h commented Aug 16, 2026

Copy link
Copy Markdown
Contributor

Records what landed across the five Go repositories, and reconciles the tasks that described the superseded direction.

Result

All five CONTRIBUTING.md files now state the shared conventions in full, under the section order repo-standards fixes:

Before you start → Prerequisites → Setup → [Project structure] →
Code style → Code standards → Testing → (repo-specific) → Before committing → …

Verified by hashing, not by reading:

Block All five
Code standards body 340c266eaf15
Test file conventions 28bb2b430230

A difference in wording would now mean a difference in rule.

nats-client and nats-server omit Project structure — permitted, since the requirement says a repository with nothing to say under a middle section omits it rather than padding it. The only capitalized heading left anywhere is ### Claude Code, a proper noun the requirement exempts. No repository lists linters in prose any more.

Landed as osapi-io/gohai#164, osapi-io/nats-client#133, osapi-io/nats-server#94, osapi-io/osapi-orchestrator#77, osapi-io/osapi#452.

Reconciles specify-go-code-standards

Tasks 2.2–2.4 are satisfied by the standardization. Task 3.6 — "confirm no shared convention is stated in two places" — is recorded as superseded: the rescope decided the opposite. A shared convention is now stated in every repository it binds, identically, because a repository has to be readable on its own. What 3.6 was aimed at (copies that disagree) is what repo-standards now forbids.

Still open

  • rescope-go-code-standards section 5 — the three hand-written mocks
  • specify-go-code-standards 3.4 and 3.5 — the same mocks, and the export_test.go audit

just test — 13 passed, 0 failed.

🤖 Generated with Claude Code

All five Go repositories now state the shared conventions in full, under
the section order repo-standards fixes. Verified by hashing: the Code
standards and Test file conventions blocks are byte-identical in all
five, and the only capitalized heading left is Claude Code, a proper
noun the requirement exempts.

The two NATS libraries omit Project structure, which the requirement
permits where a repository has nothing to say under a middle section.

Also reconciles specify-go-code-standards. Its tasks 2.2 to 2.4 are
satisfied by the standardization, and 3.6 is recorded as superseded: it
asked that no shared convention be stated twice, and the rescope decided
the opposite -- stated everywhere it binds, identically, because a
repository has to be readable on its own.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown

Thank you for contributing to this project! 😊🕹️

@retr0h
retr0h merged commit 3d97305 into main Aug 16, 2026
6 checks passed
@retr0h
retr0h deleted the chore/record-contributing-standardization branch August 16, 2026 16:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant