Documentation

@Tathanen @jrit @dmaloneycalu @thoughtpalette take a look and let me know if anything looks confusing or needs more documentation
is there really a reason that `://` should be in this? that isn't the scheme really