updating docs to TR
spellchecked
updated types in the docs
removing trailing whitespace
switched to typed/net/url over handrolled stuff