This directory contains Architecture Decision Records (ADRs) for contentful.php. Each ADR documents a significant technical decision, including the context that drove it, the choice made, and the trade-offs accepted.
Read ADRs before proposing architectural changes — if a decision has an ADR, the reasoning is documented. Don't relitigate it without reading it first.
| ADR | Title | Status |
|---|---|---|
| 0001 | Use contentful/core as the shared SDK foundation |
Accepted |
| 0002 | Accept PSR-6 (cache) and PSR-3 (logging) interfaces, not concrete implementations | Accepted |
| 0003 | Use devcontainer for reproducible local and CI environments | Accepted |
| 0004 | Run PHPStan at level 5 and accept one known violation | Accepted |
| 0005 | Use php-vcr for integration tests (and known migration debt) | Accepted (follow-up pending) |
| 0006 | Semver versioning with major bumps for PHP version drops | Accepted |