On Wed, 3 Apr 2019 at 17:27, M. W. Moe <mo.mu....@gmail.com> wrote: > yes this is very true; but usually on complex design with a lot of folks > working on it you start coding before documenting; >
If it's just syntax that doesn't change behaviour, it's really just documentation anyway, and if people are so desperate to dig into the code that they can't write a minimal docblock (or so lazy that they won't), how likely is it that they'll correctly add this new indicator? If you want to be explicit, don't put off docblocks until later (writing them before you've even implemented the function can be a great way of clarifying your design), and use an IDE or CI tool that will tell you when they're missing or incorrect. Regards, -- Rowan Collins [IMSoP]