On Sat, Mar 6, 2021 at 08:32:43PM -0500, Tom Lane wrote: > I think that the best you should hope for here is that people are > willing to add a short, not-too-detailed para to a markup-free > plain-text README file that lists all the hooks. As soon as it > gets any more complex than that, either the doco aspect will be > ignored, or there simply won't be any more hooks. > > (I'm afraid I likewise don't believe in the idea of carrying a test > module for each hook. Again, requiring that is a good way to > ensure that new hooks just won't happen.)
Agreed. If you document the hooks too much, it allows them to drift away from matching the code, which makes the hook documentation actually worse than having no hook documentation at all. -- Bruce Momjian <br...@momjian.us> https://momjian.us EDB https://enterprisedb.com The usefulness of a cup is in its emptiness, Bruce Lee
