included notes from the wiki into the project readme file, taken notes from Gnotts notes
Merge pull request #35 from elifesciences/documentation

included notes from the wiki into the project readme file, taken notes f...