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

Thanks for maintaining the docs, they've been quite readable and informative!
Merge pull request #7 from e28eta/patch-6

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