host: add a bunch of documentation