Summary
README API table at line 100+ lists Swap and Clear without their Go version requirement. A consumer pinned to Go 1.21 who uses Clear hits a build error with no warning in the table they consulted.
Scope
Add a Notes-column annotation to the Swap and Clear rows ("Requires Go 1.20" / "Requires Go 1.23"). Also mention in doc.go's Relationship section.
Acceptance criteria
- README API table cites Go version minima on Swap and Clear.
doc.go notes that CompareAndSwap/CompareAndDelete also require Go 1.20.
Source: docs-writer.
Summary
README API table at line 100+ lists
SwapandClearwithout their Go version requirement. A consumer pinned to Go 1.21 who usesClearhits a build error with no warning in the table they consulted.Scope
Add a Notes-column annotation to the Swap and Clear rows ("Requires Go 1.20" / "Requires Go 1.23"). Also mention in doc.go's Relationship section.
Acceptance criteria
doc.gonotes that CompareAndSwap/CompareAndDelete also require Go 1.20.Source: docs-writer.