diff --git a/CHANGELOG.md b/CHANGELOG.md
index f38de61..a04fd24 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,6 +7,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## 0.2.1 Under development
 
+- docs: correct the documented attribute method names and bulk-update semantics.
+
 ## 0.2.0 July 29, 2026
 
 - feat: add `SrcInterface` and `ValueInterface` to the `Attribute` namespace for elements exposing the `src` and `value` attributes.
diff --git a/README.md b/README.md
index 7015056..f89a4e1 100644
--- a/README.md
+++ b/README.md
@@ -59,7 +59,7 @@ final class MyTag implements RenderableInterface
 
 Contract for objects that manage HTML attributes with an immutable API.
 
-Methods: `attributes()`, `class()`, `getAttribute()`, `getAttributes()`, `removeAttribute()`, `setAttribute()`.
+Methods: `addAttribute()`, `attributes()`, `class()`, `getAttribute()`, `getAttributes()`, and `removeAttribute()`.
 
 #### FormControlInterface