adding more details on the intro.
adding additional comments.