Delegated behavior should be documented where users look for it
@marcdasilva▲ 3 net votes
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.