On Sat, Jun 17, 2017 at 9:53 AM, Fleshgrinder <p...@fleshgrinder.com> wrote:
> Hi! > > I started voting on the Doxygen RFC: > > https://wiki.php.net/rfc/doxygen > > -- > Richard "Fleshgrinder" Fussenegge > Can you please clarify where functions that are declared in a header and defined in a source file should be documented? I believe the usual recommendation is to document in the source file, because it's closer to the implementation and thus more likely to be updated. On the other hand, documentation in headers only is more useful if you're just browsing code and not using generated output. Nikita
