Improves documentation

fix a few typose, improve spelling and add a note about modes install order.