update network comments for readability and documentation