Another place where I would like to see some documentation (and where I usually put it) is in the *.h files (well, actually in *.ads files.
Ik ben heel benieuwd naar jouw mening, laat het me weten in de comments! •••••••••••••••••••••••••••••••••••••••••••••