Heaps more inline documentation from Jacob landed.