Revised sections 1 and 2 of the docs