added more descriptive language to index and spec, general edits

wanted to pull request to make sure all the updated language is in line with the general vision for revisitors

please let me know if anything needs revising or changing or expansion

:dancer: