v0.35.1

0.35.1 - 2026-07-16

Full Changelog: v0.35.0...v0.35.1

68 commits in this release.

---

Implemented enhancements

• feat(scanner): swagger:description | end-to-end + fixture; closes go-swagger#3211 by @fredbi ...
• feat(grammar): swagger:description | literal block scalar (lexer capture) by @fredbi ...
• feat(scanner): DefaultAllOfForEmbeds — opt-in allOf composition for plain embeds by @fredbi ...
• feat(scanner): SkipJSONifyInterfaceMethods — opt out of interface-method mangler by @fredbi ...
• feat(scanner): CleanGoDoc — marker contract for idiom recomposition by @fredbi ...
• feat(scanner): AfterDeclComments — field trailing comments (Phase B) by @fredbi ...
• feat(scanner): AfterDeclComments — annotations inside/below type decls (Phase A) by @fredbi ...
• feat(overrides): multi-line swagger:description + keyword co-location by @fredbi ...
• feat(overrides): apply swagger:description on responses & headers by @fredbi ...
• feat(overrides): apply swagger:title / swagger:description on schemas by @fredbi ...
• feat(overrides): register swagger:title / swagger:description annotations by @fredbi ...
• feat(shared-parameters): validate shared-namespace refs, drop danglers by @fredbi ...
• feat(shared-parameters): swagger:response * synonym + keep-first conflict by @fredbi ...
• feat(shared-parameters): apply path-item parameters from swagger:parameters /path by @fredbi ...
• feat(shared-parameters): wire shared parameters into operations as $refs by @fredbi ...
• feat(shared-parameters): register top-level #/parameters with keep-first conflict by @fredbi ...
• feat(shared-parameters): grammar-owned targeting parse + scanner ref discovery by @fredbi ...
• feat: response-level examples by mime on struct swagger:response by @fredbi ...
• feat: derive field names from configurable struct tags (NameFromTags) by @fredbi ...
• feat(scanner): prune unreferenced models under -m (PruneUnusedModels) by @fredbi ...

Fixed bugs

• refactor(resolvers): resolve TextMarshaler via a source-checked interface by @fredbi ...
• fix(provenance): re-point definition anchors through name reduction by @fredbi ...

Documentation

• doc: updated contributors file by @bot-go-openapi[bot] in #57 ...
• docs(doc-site): document swagger:title / swagger:description annotations by @fredbi ...
• docs(doc-site): railroad (syntax) diagrams for the EBNF grammar by @fredbi ...
• docs(doc-site): rework annotation pages — Usage quick-form + live examples by @fredbi ...
• docs(doc-site): one page per swagger:* annotation; alpha-sort the index by @fredbi ...
• doc: updated roadmap ; clean up comments by @fredbi ...
• doc: reformatted go comments by @fredbi ...
• docs(doc-site): tabbed-example pilot — live SwaggerUI on a tutorial pane by @fredbi ...
• docs: subsection the "Shaping the output" menu + add Options reference by @fredbi ...
• docs: doc-site coverage for AfterDeclComments by @fredbi ...
• docs: doc-site coverage for swagger:title / swagger:description overrides by @fredbi ...
• docs: doc-site coverage for shared parameters & responses by @fredbi ...
• docs(grammar): document swagger:description | literal block by @fredbi ...
• docs(builders): document CleanGoDoc — godoclink README + scanner §clean-godoc by @fredbi ...
• docs(scanner): document AfterDeclComments; alias coverage; defer const-enum by @fredbi ...
• docs(overrides): document swagger:title / swagger:description overrides by @fredbi ...
• feat(shared-parameters): prune unreferenced shared params/responses under -m by @fredbi ...
• docs: doc-site coverage for NameFromTags and response examples by mime by @fredbi ...
• doc: publish 2026 roadmap for codescan by @fredbi in #52 ...
• ci: post README announcements to discord + bump ci-workflows to v0.4.0 by @fredbi ...

Code quality

• chore: relint by @fredbi ...
• docs(doc-site): generalize the live-spec tab into example by @fredbi ...
• docs(doc-site): render the capstone spec live with Swagger UI (W1) by @fredbi ...
• docs: doc-site coverage for swagger:description | (verbatim markdown) by @fredbi ...
• docs: doc-site coverage for DefaultAllOfForEmbeds + SkipJSONifyInterfaceMethods by @fredbi ...
• docs: doc-site coverage for CleanGoDoc (godoc doc-links) by @fredbi ...
• feat(scanner): CleanGoDoc — idiom recomposition resolver + substitution by @fredbi ...
• feat(scanner): CleanGoDoc — godoc-syntax filtering (strip/humanize) by @fredbi ...
• docs(doc-site): add "Pruning unused models" shaping-the-output guide by @fredbi ...

Testing

• test(scanner): golden-pin the AfterDeclComments OFF case by @fredbi ...
• test(shared-parameters): witness the prune cascade by @fredbi ...
• test(shared-parameters): golden coverage for fixtures 1/3/4/5 (P8) by @fredbi ...

Miscellaneous tasks

• test(ci): guard TextMarshaler toolchain-independence by @fredbi ...
• fix: make TextMarshaler detection independent of the toolchain environment by @KT-Doan ...

Security

• docs(doc-site): restructure keyword reference into class pages by @fredbi ...
• docs(doc-site): roll out the live SwaggerUI tab to route-bearing tutorials by @fredbi ...

Updates

• chore(deps): Bump golang.org/x/tools from 0.47.0 to 0.48.0 in the golang-org-dependencies group by @dependabot[bot] in #59 ...
• chore(deps): Bump the go-openapi-dependencies group with 2 updates by @dependabot[bot] in #58 ...
• chore(deps): Bump github.com/go-openapi/testify/v2 from 2.5.1 to 2.6.0 in the go-openapi-dependencies group across 1 directory by @dependabot[bot] in #54 ...
• chore(deps): Bump golang.org/x/tools from 0.46.0 to 0.47.0 in the golang-org-dependencies group by @dependabot[bot] in #53 ...

Other (technical)

• Chore/toolchain independence enhancement by @fredbi in #61 ...
• fix: make TextMarshaler detection independent of the toolchain environment by @fredbi in #60 ...
• Doc Maintainers by @fredbi in #56 ...
• Feat/feature v0.36 by @fredbi in #55 ...
• ci: post README announcements to discord + bump ci-workflows to v0.4.0 by @fredbi in #51 ...
• Feat/prune unreferenced models by @fredbi in #50 ...

---

People who contributed to this release

• @KT-Doan
• @fredbi

---

codescan license terms