From a9442de1f568cd6a4ee7223c59b0a017d3e95377 Mon Sep 17 00:00:00 2001
From: Moamen Eltouny <raggigroup@gmail.com>
Date: Thu, 8 Oct 2026 13:07:33 +0300
Subject: [PATCH] Show six feature cards in the documentation overview

---
 CHANGELOG.md                 | 6 ++++++
 docs/sections/01-overview.md | 6 ++++++
 2 files changed, 12 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2903ff7..d3ceab9 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,12 @@
 
 All notable changes to this project will be documented in this file.
 
+## 8.1.1 - Unreleased
+
+### Changed
+
+- The documentation overview shows six feature cards, adding Reference Mode and ArrayAccess & Countable.
+
 ## 8.1.0 - 2026-10-08
 
 The `8.1.x` line targets PHP 8.1. Results are identical to `8.0.0`. See [UPGRADE.md](UPGRADE.md#from-80-to-81).
diff --git a/docs/sections/01-overview.md b/docs/sections/01-overview.md
index 65a3648..ab968e8 100644
--- a/docs/sections/01-overview.md
+++ b/docs/sections/01-overview.md
@@ -20,6 +20,12 @@ Read, write, check and delete values in deeply nested PHP arrays using dot-notat
 
 ### Escaping {icon="pencil"}
 `config.app\.name` reads the key `app.name`; `items.\*` reads the key `*`.
+
+### Reference Mode {icon="switch"}
+`setReference($array)` writes every change straight to your own array.
+
+### ArrayAccess & Countable {icon="lines"}
+`$dot['user.name']`, `isset()`, `unset()`, `count()`, iteration and `json_encode()` all work.
 :::
 
 :::info Quick Tip