docs($state): document 'parent' parameter