这点确实少见，很多项目文档就是把函数签名抄一遍

Agreed, and it is a decent proxy for how much the team actually understands their own design. Docs that only describe behaviour usually mean the behaviour was discovered, not chosen.