Community · ASP process
Submit an AXL Specification Proposal.
The ASP is the unit of substantive comment on the specification. Each receives a public disposition from the relevant working group.
- File at
- github.com/tony-toubia/axlspec.org/issues
- Review
- Working groups, biweekly
- Credit
- Editorial section of subsequent versions
§ 1What an ASP looks like
An ASP is a GitHub issue on github.com/tony-toubia/axlspec.org, labelled asp. It contains:
- Clause cited. The exact clause of the specification being challenged or extended (e.g. § 5.2 Decide — Recommended capabilities).
- Proposed change. The specific replacement, addition, or deletion proposed.
- Rationale. Production evidence, citation to adjacent specifications, or a counter-example to the current wording.
- Compatibility. Whether the change is breaking against v1.0 Final, and if so, why a major-version change is warranted.
§ 2What happens to an ASP
- The editorial board labels the ASP with the receiving working group.
- The working group triages at its next biweekly meeting and posts a tentative disposition.
- If accepted: the change lands in a Release Candidate and the proposer is credited in the editorial section.
- If deferred: a target version is named (e.g. v1.1, v2.0).
- If declined: a written rationale is posted to the disposition log.
§ 3Disposition log
Every ASP receives a public disposition, recorded in the issue thread and indexed in the disposition log forthcoming in the project repository. The log is the authoritative record of substantive comment on the specification.
ASPs that cite production evidence not yet accounted for in the specification are likely to receive the most substantive working-group consideration. The current draft is at /spec/v1.0.