expand + update documentation, more detailed error msg
update GitHub repo URL