diff --git a/CHANGELOG.md b/CHANGELOG.md index c6182c73..5f78c907 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,10 +5,25 @@ follow semantic versioning; release dates are ISO 8601. ## v1.6.6 — Planned -First Maven Central release. Adds publishable sources/javadoc jars, -GPG-signed artifacts, a binary-compatibility gate against v1.6.5, and -the metadata Maven Central requires. Zero breaking changes; users on -JitPack continue to resolve through the existing coordinates. +**First Maven Central release.** GraphCompose now ships under +`io.github.demchaav:graphcompose:1.6.6` alongside the existing +JitPack distribution. The release adds publishable sources/javadoc +jars, GPG-signed artefacts, a binary-compatibility gate against +v1.6.5, the metadata Maven Central requires, and a substantial +documentation polish for the maturity / stability / migration story. + +**Zero breaking changes from v1.6.5.** Existing JitPack callers continue +to resolve through the same coordinates; existing API surface compiles +and runs unchanged (validated by the new `japicmp` gate against the +v1.6.5 baseline). New: the `@Beta` annotation marker, the `@since 1.0.0` +class-level Javadoc on entry-point packages, and a curated docs pass +(decision guide for the two template surfaces, examples maturity index, +explicit API stability policy). + +**Migration from v1.6.5:** no code changes required. Optionally swap +the JitPack `` for the Maven Central equivalent +(`io.github.demchaav:graphcompose:1.6.6`); both publish paths continue +to ship the same artefact. ### Build diff --git a/README.md b/README.md index 1abbf7ce..ae086ee0 100644 --- a/README.md +++ b/README.md @@ -12,12 +12,19 @@

CI Latest release + Maven Central JitPack Java 17+ PDFBox 3.0 MIT License

+> **Release status** — +> 🟢 **Latest stable**: [v1.6.5](https://github.com/DemchaAV/GraphCompose/releases/tag/v1.6.5) (JitPack) +>  ·  🟡 **In develop**: v1.6.6 (Maven Central debut; zero breaking from v1.6.5) +>  ·  ⚪ **Planned next**: v1.6.7 (dependency cleanup), v1.7.0 (new canonical DSL primitives) +>  ·  See [API stability policy](./docs/api-stability.md) for tier definitions. +

Live Showcase  ·  @@ -87,6 +94,22 @@ GraphCompose uses PDFBox under the hood as the rendering backend — the com ## Installation +### Maven Central (primary, from v1.6.6) + +```xml + + io.github.demchaav + graphcompose + 1.6.6 + +``` + +```kotlin +dependencies { implementation("io.github.demchaav:graphcompose:1.6.6") } +``` + +### JitPack (fallback / pre-v1.6.6) + ```xml jitpack.iohttps://jitpack.io @@ -206,7 +229,8 @@ document.pageFlow().addCanvas(523, 360, canvas -> canvas - [Examples gallery](./examples/README.md) — every runnable example with PDF preview ### Contributing & releases -- [Migration v1.5 → v1.6](./docs/roadmaps/migration-v1-5-to-v1-6.md) · [Release process](./docs/contributing/release-process.md) · [Contributing](./CONTRIBUTING.md) +- [Contributing](./CONTRIBUTING.md) · [Code of conduct](./CODE_OF_CONDUCT.md) · [Security policy](./SECURITY.md) · [Release process](./docs/contributing/release-process.md) +- [API stability policy](./docs/api-stability.md) · [Which template system?](./docs/templates/which-template-system.md) · [Migration v1.5 → v1.6](./docs/roadmaps/migration-v1-5-to-v1-6.md) ## Companion projects