document that paths are allowed