DOC Document PHPDoc as a PHP coding standard

Description

Documents the need for PHPDoc in general (which I was surprised was missing), and the need for @method annotations in particular.

[x] The target branch is correct
- See branches and commit messages
[x] All commits are relevant to the purpose of the PR (e.g. no TODO comments, unrelated rewording/restructuring, or arbitrary changes)
- Small amounts of additional changes are usually okay, but if it makes it hard to concentrate on the relevant changes, ask for the unrelated changes to be reverted, and submitted as a separate PR.
[x] The commit messages follow our commit message guidelines
[x] The PR follows our contribution guidelines
[x] The changes follow our writing style guide
[x] Code examples follow our coding conventions
[x] CI is green