moving documentation around into some kind of coherent non-mess, eventually.