be more explicit about spec expectation for directory parameter validation