DOC Document PHPDoc as a PHP coding standard

en/05_Contributing/05_Coding_Conventions/01_PHP_Coding_Conventions.md

@@ -157,6 +157,16 @@ Order code in classes in the following order:
 - If you do write raw SQL, use double quotes around table/column names and use parameterised queries, for example `->where(['"Score" > ?' => 50])`.
 - Use [ANSI SQL](https://en.wikipedia.org/wiki/SQL#Standardization) format.
 
+## PHPDoc
+
+PHPDocs are not only useful when looking at the source code, but are also used in the API documentation at <https://api.silverstripe.org>.
+
+- All [public API](/project_governance/public_api) should have a PHPDoc to describe its purpose.
+- All `DataObject` and `Extension` subclasses should have `@method` annotations in their PHPDoc for relations (`has_one`, `has_many`, etc).
+  - Do not add the annotation if a real method is declared with the same name.
+  - Include the relevant `use` statements for all classes mentioned in the annotation
+  - Return types should include generics, e.g. `@method HasManyList<Member> Members()`
+
 ## Other conventions
 
 - Prefer the identical `===` operator over the equality `==` operator for comparisons.