docs: changelog + reference.md for the JPMS module descriptor; accept ADR 0011

CHANGELOG.md — 0.8 Added entry for the module-info.java change.
docs/reference.md — spell out the module-path native-access flag
(--enable-native-access=io.github.dfa1.zstd) and add a Module path
section describing the export surface and classpath fallback.
adr/0011-jpms-module-descriptor.md, adr/ADR.md — flip status
Proposed -> Accepted now that the descriptor is implemented.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

Author: dfa1

CHANGELOG.md

@@ -4,6 +4,15 @@ All notable changes to this project are documented here. Format loosely follows
 [Keep a Changelog](https://keepachangelog.com/); versions are released as `v*`
 git tags, which trigger publication to Maven Central.
 
+## [0.8]
+
+### Added
+- `module-info.java`: `zstd` now ships as a named JPMS module
+  (`module io.github.dfa1.zstd`), exporting the single public API package.
+  Module-path consumers grant `--enable-native-access=io.github.dfa1.zstd`
+  instead of `ALL-UNNAMED`; classpath consumers are unaffected. See
+  [ADR 0011](adr/0011-jpms-module-descriptor.md).
+
 ## [0.7] - 2026-06-28
 
 ### Changed

adr/0011-jpms-module-descriptor.md

@@ -1,6 +1,6 @@
 # ADR 0011: JPMS module descriptor
 
-- **Status:** Proposed
+- **Status:** Accepted
 - **Date:** 2026-06-27
 - **Deciders:** project maintainer
 

adr/ADR.md

@@ -29,7 +29,7 @@ shipped, so contributors can see *why* the project looks the way it does.
 | 0008 | `size_t` maps to `JAVA_LONG`, guard sentinels      | Accepted  |
 | 0009 | `NativeObject`: AutoCloseable, idempotent close    | Accepted  |
 | 0010 | Bounded native-context pool for virtual threads    | Proposed  |
-| 0011 | JPMS module descriptor                             | Proposed  |
+| 0011 | JPMS module descriptor                             | Accepted  |
 | 0012 | Benchmark methodology and publishing               | Proposed  |
 | 0013 | Binding coverage scope — exclude legacy/deprecated | Accepted  |
 | 0014 | Single-threaded native build (no `nbWorkers`)      | Accepted  |

docs/reference.md

@@ -30,8 +30,18 @@ with a per-area breakdown and a comparison against zstd-jni:
 
 ## Runtime requirement
 
-Native access requires `--enable-native-access=ALL-UNNAMED` (or your module name)
-on the JVM command line.
+Native access requires a flag on the JVM command line: `--enable-native-access=ALL-UNNAMED`
+on the classpath, or `--enable-native-access=io.github.dfa1.zstd` on the module path.
+
+## Module path
+
+`zstd` ships a `module-info.java` declaring `module io.github.dfa1.zstd`, which
+exports only the public API package (`io.github.dfa1.zstd`). The native library
+still comes from the separate `zstd-native-<classifier>` artifact, loaded at
+runtime — it is not itself a JPMS module. Putting the jar on the classpath
+instead of the module path works unchanged (it becomes part of the unnamed
+module and the descriptor is ignored). See
+[ADR 0011](../adr/0011-jpms-module-descriptor.md) for the design rationale.
 
 ## Build from source