update docs and installation instructions
with the help of costasd