[dharmab]

A docstring won't contain the necessary context for "why", and is something I see coding assistants get consistently wrong without human data.

[bee_rider]

OTOH doctrines at least have a slight chance of being updated along with the code.