moved References to rst file.
references added. intro updated. roles updated.