io: add comments based on review feedback