doc: install instructions
doc: there are only two interfaces
iteration respects order