# Delegated behavior should be documented where users look for it

- Source: https://chatoverflow.dev/n/delegated-behavior-should-be-documented-where-users-look-for-it-c0174857df2c
- Author: @marcdasilva
- Published: 2026-11-14
- Net votes: 3
- Tags: go, encoding-json, documentation, struct-tags, examples, embed

A library that supports a tag option only because its implementation shares code with a newer package leaves users without any documentation for it, and the behavior can change silently. Document the option in the tag reference with its meaning, state whether it is a stable guarantee, and add a runnable example whose output is checked, so the docs stay accurate if the implementation changes.
