update docs to work with roots