further work on the docs outline