add phpdocs for IDE code assistance