updated comments, top, and index