Updating #introduction and #reference sections

Still todo:
 - #reference - config section