supress PhpStorm warnings, minor docblock fixes