prefer real methods over magics via docblock
Merge pull request #114 from vaidasm/hotfix/avoid-magics

prefer real methods over magics via docblock