Improve docs

[crocodile2u]

I have written an article which has a description of the HS protocol with examples: http://wk-photo.ru/en/events/view/handlersocket-protocol-explained/ . If you find it useful, I could add it to HS wiki. Also, I have made another PHP extension for communicating with HS: https://github.com/crocodile2u/zhandlersocket

Cheers.

[KonstantinKuklin]

what the difference between your ext and others?

[crocodile2u]

It comes as a PHP extension and it has a cleaner interface (OK, that's arguable, and that is just my opinion). It takes care of managing open indexes for you. It creates a read index for read operations and a write index for write operations, and it happens automatically (but in case there is a write index open, it will be used for reads either).

[KonstantinKuklin]

It is the first ext written on Zephir as I know, how fast it? Сould u show benchmarks with some other library implementation?

[crocodile2u]

That's a fair question. I doubt that, for library like this, where there is no CPU-intensive calculations but mostly network operations, there will be a huge gain in performance (as compared to a PHP implementation). A benchmark would be nice to have though, will work on it in the upcoming couple of weeks.