Repository navigation
docs: guides for extending Comline - #105
Merged
Merged
Conversation
…nerators, transports, dispatchers) Adds guide/extending, the generator protocol and conformance spec reference pages, comline conformance / generator / encodings in the CLI and comline.toml references, and marks the extensibility proposal and Proposal D implemented.
The CLI repository now has test fixture packages that also build binaries, so cargo install --git needs the package named.
This was referenced Oct 31, 2026
Closed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #99
Guides for extending Comline (B7 of the extensibility plan). Everything described is merged; what isn't built is listed on the guide's index page and in the proposal's "What shipped".
Pages added:
guide/extending/index.md: the five extension points, the rules, registry names deferred to core#8, what isn't builtguide/extending/encodings.md: declaring, profile, vectors,comline conformance, schema use, mapping incomline.tomlguide/extending/handshakes.md,generators.md,transports.md,dispatchers.mdreference/generator-protocol.md: protocol 0, Describe and Generate, limits and path rulesreference/conformance.md: spec 0.1, case format, ops protocol, vectors conventionPages changed:
proposals/extensibility.md: status implemented, "What shipped" with PR links;proposals/index.mdentryproposals/codegen-architecture/target-language-plugins.md(Proposal D) and its index: implementedreference/cli.md(comline conformancerow),reference/congregation/comline-toml.md(generator,timeout,encodings),guide/packages/index.md(encodingskey)mkdocs.yml: nav entrieszensical build --strictpasses and every internal anchor was checked in the built site. The Rust examples (dispatcher wrapper, blocking and async handshake, transport) were compiled against the runtime.