top | item 18437485

(no title)

rajeshpant | 7 years ago

I want to find the guy who wrote this documentation :

"H2O is a powerful web server used and developed by Fastly" - Ok.

"H2O is a new generation HTTP server that provides quicker response to users with less CPU utilization when compared to older generation of web servers" - Great

This is where it becomes cringy : "H2O as a web server is very impressive and is seeing more and more use"

more

"I have used more web server frameworks than is reasonable. libh2o is by far the most impressive effort "

"The H2O maintainers are incredibly friendly and helpful."

I scrolled half the page and still doesn't provide any useful information.

If you happen to write or own any documentation. Please don't use filler use marketing language. Please.

discuss

order

ahubert|7 years ago

Hi Rajesh, thank you for your thoughtful critique of my documentation efforts! I took a look at the sentences that are hurting you. The first part is from H2O's mission statement, which is clearly quoted. H2O is very impressive and is seeing more and more use. The h2o maintainers are indeed very friendly and helpful. But perhaps that is because I approached them with respect and did not hate them for their mission statement? We may never know. If you have anything useful to add, the document can be edited through https://github.com/ahupowerdns/hello-libh2o

rajeshpant|7 years ago

Thank you very much for replying. I will take a look at the docs & github repo more closely and provide suggestions.

st3fan|7 years ago

There are 17 sections of which 16 are technical and you complain about the “Hello and Welcome” ???