make documentation more usef friendly

[bettylorang]

documentation for the code should assume no prior knowledge of the project (are the text files self-created, for example?) Explain more of the WHYs and more details on the set-up (e.g., linux-based system).