add notes on I/O actions