PIM-3151: Add specs
PIM-3151: Fix phpdoc