document things a bit