Documentation

@Tathanen @jrit @dmaloneycalu @thoughtpalette take a look and let me know if anything looks confusing or needs more documentation
this is why taking an object usually is better than listed parameters in JS