[erlang-questions] [ANN] Cowboy 2.0.0-pre.4

[Ladislav Lenart]

Hello.

Just my 2 cents after skimming through the new manual. But first a disclaimer:

I do not program in Erlang (anymore). I just keep an eye on various projects
created using it and love to read the mailing list. I have never used the cowboy
web server...

With that in mind, the manual is simply excellent! Great work!

What I like:
+ It seems (though I have not verify it) that it is just a static HTML.
+ The version number is part of the URL. Awesome! I do not dare to count the
number of times when I got lost in the Apple documentation or when I have found
a link which no longer works.
+ Detailed explanation of arguments with simple examples.
+ Oh, the usage examples!

What I have not found (though I have not red the entire manual):
- A top-level overview where the concepts such as protocols, handlers, behaviors
and middlewares are explained (i.e. what is it, when to use it and why and its
relations to others).

Out of curiosity, why (in cowboy:start_clear) is TransportOpts a list of pairs
while ProtocolOpts is a map? Is this to ensure that the user does not swap them
unwittingly?


Happy New Year and keep up the great work,

Ladislav Lenart


On 3.1.2017 14:48, Loïc Hoguin wrote:
> Hello and happy new year!
> 
> Cowboy 2.0.0-pre.4 has been released. It is a significant progress over 
> the previous pre-release and contains most of the breaking changes I 
> wanted for Cowboy 2.0.
> 
> Details on the release can be read at:
> 
>     https://ninenines.eu/articles/cowboy-2.0.0-pre.4/
> 
> There will be mostly weekly pre-releases from now until the 2.0 release 
> candidate. They will only be announced on the website and social media.
> 
> I encourage everyone to try this new version and report any problems 
> (bug, missing features, compatibility issues).
> 
> A lot of work went into the manual. If you recall the long documentation 
> thread from a few months back, I have put all my suggestions into the 
> Cowboy manual: https://ninenines.eu/docs/en/cowboy/2.0/manual/ and would 
> love to know what you think.
> 
> I have ignored tickets and PRs for some time to get this release out. I 
> will now start merging and fixing things again. Thanks for your patience.
> 
> As always, your feedback is most important.
> 
> To a great Cowboy year,