add a bit of documentation