clarity and documentation fixes
clarity and documentation fixes

fabianvf/scrapi,fabianvf/scrapi,ostwald/scrapi,CenterForOpenScience/scrapi,erinspace/scrapi,alexgarciac/scrapi,felliott/scrapi,mehanig/scrapi,erinspace/scrapi,jeffreyliu3230/scrapi,CenterForOpenScience/scrapi,mehanig/scrapi,icereval/scrapi,felliott/scrapi