Expanding the PHPDoc comments to clarify concepts