document the directory name constraint

fixes #1