some initial documentation and questions