document new workdir behavior