A Manifesto * Undated

Structure is
a form of verse.

I. Craft

We are engineers who read poetry, and readers who happen to write compilers. We hold that the two vocations are one.

A grammar is a claim about how the world may be spoken; a parser is a promise to honor that claim. Neither is a small undertaking.

II. The small languages

AsciiDoc, Markdown, reStructuredText, BibTeX, Org — the small markup languages carry the world's serious writing. Their specifications live half in prose, half in code, and often entirely in one implementation nobody dares to fork.

We intend to fork them, kindly.

III. Method

We build in the open, without haste. We prefer a slow parser that is correct to a fast one that is nearly so. We prefer a small library to a framework. We prefer a README a stranger can read on a train.

We release under Apache-2.0. We accept contributions in the spirit of a workshop, not a factory.

IV. First work

Our first subproject is asciidoc-kmp — an AsciiDoc parser written in Kotlin, targeting every runtime Kotlin reaches. It is early. It is honest about being early. It will improve with attention.

Coda

If any of this speaks to you, come sit with us.