upgrade to the latest shoppe & add more docs