fixes for policy files, docs for same