install scripts update plus documentation
Ticket #331: Improved error messages for Hop + fixes and refactor + tests