update README
update big picture discussion
update .rst output script
edits to running_avg discussion
make headers consistent