MINOR: Improved docs

Quick docs update due to internal request: Contains some Schema examples, typos fixed and external links have been hyperlinked.