Add better phpdocs to common operation methods