update main documentation

with new installation instructions, and to fix links