add comments and important notes