updated detailed guide and fixed tests