change some subsection names
update wording in intro and specs
add if __name__ section