> Powerful server for Node.js that just works so you can focus on your awesome project
This is not a "quick general description of the problem the project solves" and I don't even know what the code does after reading this. You can do better than this.
Agreed, I haven't liked that line for a while. What about something like this?
> A server for Node.js that works out of the box with modern Javascript
It is a Node.js server with a bunch of middleware so that you don't need to do common things like body-parser, cookies, etc. It's also based around async/await instead of callback-based, which makes it easier to work with more modern JS and that prevents me from calling something like "express wrapper" or similar.
My first problem is that "a server" only tells me it probably listens on a socket.
Is it a web server, a web framework, a PBX, telnet or general TCP, UDP or Unix socket support functions? Which protocols does it run? Is it a library? Is it a daemon?
It says so little, it could be literally anything.
I guess it has something to do with HTTP and I guess it's a library/framework because I guess a web developer wrote this, but only because it mentions JavaScript and doesn't specify further. But these are still just guesses, I wouldn't know from the text alone.
> works out of the box with modern Javascript
Does it work with other languages too, just not out of the box? If not, the "out of the box" doesn't add anything here. Doesn't similar code work out of the box anyway?
No, very notably both Express and its modern counterpart Koa don't work out of the box and devs using them have to learn, install and configure quite a few packages (middleware). This includes common functions like parsing the body of an HTTP request, parsing cookies, etc. This is the reason I created `server` in the first place, to do `npm install server` and not worry about these things on a per-project basis :)
Thanks for all the feedback, I'll replace "server" for "webserver" in my previous sentence. That alone is a great improvement over the current text IMHO.
That sounds like a marketing slogan, and honestly the JS ecosystem has so many of these that they've become meaningless.
What your thing looks to be is a wrapper over Node's `http` module, with a simplified API. "Powerful" is really not an appropriate adjective, since obviously your lib is limited to what the underlying Node's http module can do (and I'm going to go on a limb and guess that your library doesn't natively handle things like streaming or chunking or UPGRADE for web sockets or HTTP/2 push or N number of other things, considering you claim the library is also "simple").
Instead of trying to over-simplify things for a nice one-liner:
> A server for Node.js that works out of the box with modern Javascript
Just give me the more verbose, but more conversational, explanation.
> It is a Node.js server with a bunch of middleware so that you don't need to do common things like body-parser, cookies, etc. It's also based around async/await instead of callback-based, which makes it easier to work with more modern JS and that prevents me from calling something like "express wrapper" or similar.
Sure it's more words, but I didn't have to think as much :)
Node.js web server that bundles and configures a lot of middleware so you don't have to.
Or something along the lines. Instead of hinting what is the gist of how it works, say it straight away.
> Powerful server for Node.js that just works so you can focus on your awesome project
This is not a "quick general description of the problem the project solves" and I don't even know what the code does after reading this. You can do better than this.