bit more work on documentation and slides