improved guide and fixed a lot of typos