Skip to content

docs(examples): build the API-Only TranscriberJ examples with TranscriberJ 0.3.6 and Publisher 0.7.0 - #94

Merged
Arc-E-Tect merged 1 commit into
mainfrom
docs/description-bundles-example-current
Sep 19, 2026
Merged

Arc-E-Tect merged 1 commit into
mainfrom
docs/description-bundles-example-current

Conversation

@Arc-E-Tect

Copy link
Copy Markdown
Owner

What

Both API-Only TranscriberJ examples now build with the current releases:

  • com.arc-e-tect.api-only-transcriberj 0.3.2 goes to 0.3.6, in gradle/libs.versions.toml;
  • @arc-e-tect/api-only-publisher 0.5.0 goes to 0.7.0, in package.json and package-lock.json.

The REST Docs emitter stays at 0.1.1, which is still its latest release.

Why

The guides in the API repository run these examples and record the versions they were verified with. Arc-E-Tect/SoftwareEngineeringDoneRight-API#35 re-ran them with these releases and now records them, so the examples have to build with the same versions.

Verified

In each example, I ran every command and experiment in its guide with these versions:

  • description-bundles: ./gradlew test, with -PdocsLocale=nl and with -PdocsLocale=fr. The generated KEYS, the generation report and the generated field line match the guide. So do the Dutch fallback experiment, the new-field experiment (the report and the placeholder line) and the renamed-schema orphan test's message.
  • hand-written-contract-tests: ./gradlew check runs 23 tests, all passing. The report, CreateRefundOperation's constants and the degraded body(...) match the guide. The removed-constant experiment gives two compile errors, which this README already says; the guide now shows both. The renamed-member guard's hashes match, and so does the named-branches remedy (the Javadoc and CardRefundV1.body).

Neither apionly.lock changed: Publisher 0.7.0 builds both contracts byte for byte as 0.5.0 did.

Note

TranscriberJ 0.3.6 still brings in Subscriber 0.2.1, so these examples use that Subscriber. That is being fixed in the TranscriberJ itself, in the API repository; neither example sets anything that 0.2.1 lacks.

@Arc-E-Tect
Arc-E-Tect merged commit e1361aa into main Sep 19, 2026
2 checks passed
@Arc-E-Tect
Arc-E-Tect deleted the docs/description-bundles-example-current branch September 19, 2026 11:59
@Arc-E-Tect

Copy link
Copy Markdown
Owner Author

🎉 This PR is included in version 1.0.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

@Arc-E-Tect

Copy link
Copy Markdown
Owner Author

🎉 This PR is included in version 1.0.2 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

@Arc-E-Tect

Copy link
Copy Markdown
Owner Author

🎉 This PR is included in version 0.2.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

@Arc-E-Tect

Copy link
Copy Markdown
Owner Author

🎉 This PR is included in version 1.0.2 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

@Arc-E-Tect

Copy link
Copy Markdown
Owner Author

🎉 This PR is included in version 1.0.1 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant