update to include i/o documentation