iterator: add a bit of documentation