Skip to content

Rewrite the specification as a formal draft - #3

Merged
kinlane merged 1 commit into
mainfrom
formal-draft
Oct 22, 2026
Merged

kinlane merged 1 commit into
mainfrom
formal-draft

Conversation

@joostfarla

Copy link
Copy Markdown
Member

This replaces SPECIFICATION.md with a Bikeshed draft in v1/ that states the format as Spectral and OpenLint behave today, as identified requirements with conformance tests.

What it adds:

  • 93 requirements in four conformance classes, with 238 tests as data that pass against both linters.
  • The JSON Schema at v1/ruleset.schema.json, with a per-release $id and property tables generated from it.
  • Tools to build, check, test and release the draft, with CI on pull requests, publishing from main, and Dependabot.
  • 33 open issues, each stating current behavior and a proposed change.

AI use: Claude Code produced the first draft, fixtures and tools; the rest is my editing, verification and restructuring.

@joostfarla
joostfarla requested a review from kinlane October 22, 2026 13:51
@kinlane kinlane self-assigned this Oct 22, 2026
@kinlane
kinlane merged commit 746a6cf into main Oct 22, 2026
3 checks passed
@kinlane
kinlane deleted the formal-draft branch October 22, 2026 14:44
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.

2 participants