prefer real methods over magics via docblock