b3d342d6
codegen: protoc-gen-tarantool-doc — Markdown reference plugin
Sibling Go plugin under cmd/protoc-gen-tarantool-doc that emits one
Markdown file per input .proto. Sections (omitted when empty):
- Header (path, package, imports)
- Messages (per-message description + field table:
# | Field | Type | Label | Description)
- Enums (value table)
- Services (method table with unary/client/server/bidi label)
Field type cells render scalar names, full type names for message/enum
references, and `map<K, V>` for maps. Synthetic map-entry messages are
skipped. Leading comments preserved via SourceCodeInfo (squashed to a
single line inside table cells).
Built via `make build-doc`; sample output committed at
examples/docs/hello.md via `make gen-docs`. Smoke tests in
test/doc_test.lua build the plugin if needed and assert the expected
sections and labels appear. 403/403 luatest green.
Eugene Blikh <bigbes@gmail.com> — 2026-05-15 18:42:11 UTC
Commit b3d342d67c5e2fcce101fdafe3aae3c5120f1e73 —
view raw patch
Parent(s):
78d234c1
| File | Status | + | − |
|---|---|---|---|
.gitignore
|
M | +1 | |
Makefile
|
M | +17 | -2 |
cmd/protoc-gen-tarantool-doc/main.go
|
A | +308 | |
examples/docs/hello.md
|
A | +111 | |
test/doc_test.lua
|
A | +126 |