BP PHPDoc Inline Documentation
BuddyPress strives for the most complete internal documentation possible. When contributing patches to BuddyPress, you are highly encouraged to document your code using our standards. We also welcome patches that provide new documentation, or correct/amend existing documentation.
BuddyPress’s documentation is based on WordPress’s PHP Documentation Standards. Familiarize yourself with that document before continuing with this guide.
There are a number of ways in which BuddyPress’s standards differ from WordPress’s. They are listed below. For any aspect of inline PHP documentation not specifically discussed here, you can assume that we are doing things the WordPress way.
- Short description For consistency, short descriptions should be written as imperatives: “Fetch a piece of metadata about a group” rather than “Fetches a piece of metadata….”