Docs in readme, cleaned code comments.

Add build and npm module badges.
Keep function params same as jsdocs.
Merge pull request #11 from expressjs/docs

Docs in readme, cleaned code comments.