add notes on flow control