Adding missing return type, fix it's/its typos

Thanks for maintaining the docs, they've been quite readable and informative!