Code documentation

[ollytom]

I'm personally familiar with C and Golang style code documentation: section 3 manpages and godoc. But because of my considerable noob factor I can't seem to find a standard, simple way to write and maintain PHP docs.

The main info we need is the same as any C stdlib function or php function:

• name
• synopsis
• description
• parameters
• return values

[afoster]

https://www.phpdoc.org/ is probably the industry standard.