fixes the setup, improves the documentation