Include design considerations in README

[mojodna]

Why would I want to use this instead of fictorial's lib? What differences are there (philosophical, primarily; I'd assume that the API differs)?

[mranney]

Yeah, I agree. This needs to be documented more clearly.

The API for basic commands is identical. The primary difference is that this one works in the latest versions of node, and this one is published in npm.

[mranney]

I've updated the README. Does that address your concern?

[mojodna]

Yes, that's super-helpful. I'm still curious about the high-level decisions that make it fast, but the fact that the README now acknowledges other options and includes differentiators is huge.

[mranney]

I'm not entirely sure about all the sources of speed gain. I hand-rolled a byte-at-a-time parser, and have special optimizations for small replies.