updated the document by re-arranging and re-wording some of Allan Branch's great additions