the phpdoc is a bit weird in the base class as this is not a filesystem path. what paths and ids do we need?