updated README with accurate examples. updated documentation comments in the manifests