some documentation and thoughts about further work