report errors better
fix typo in the docs and add more details about site__full_name