tried to add some clarity around the dir option