The specification for Oval, a plain-text file format for voting guides.
SPEC.mdis the specification. It is published at spec.oval.vote using spec-mdgrammar.txtis Appendix A extracted verbatim, for tools that want only the grammar.packages/oval-schema/oval.schema.jsonis the JSON Schema for the compiled output of a voting guide, published to npm as@oval-vote/oval-schemawith TypeScript types generated from it. Section 5.2 of the specification is generated from it bynpm run shape.examples/franklin.ovalis a full-scale fictional guide that exercises every construct in the specification.examples/franklin.oval.jsonis the compiled output of that guide, which validates against the schema.
The reference implementation is oval-vote/oval.
The Set Version, Release, and Unrelease workflows under Actions manage versions and editions, as
their descriptions say; mise run set-version and mise run version:check do the version part
locally. A release publishes @oval-vote/oval-schema to npm. Running Release with the draft option
instead publishes a prerelease of the package from main under the draft dist-tag, with no
edition and no release, for tools that build against the schema before the specification ships.
The specification and everything published with it are licensed under
CC BY 4.0; see LICENSE.