improved scope readme