ninenines / ninenines.github.io Goto Github PK

In the subprotocol section the init is returning {stop, Req, State}. I think this is not a valid return value as only ok and handler module name can be returned as the first element in the tuple.

Should put a last update to the old URL to inform everyone that it changed.

There's a few errors when generating the documentation. They should be fixed in individual projects.

In the source code, rate_limited/2 comes after forbidden/2 instead of valid_entity_length/2 in the image.

https://github.com/ninenines/ninenines.github.io/blob/master/docs/en/cowboy/1.0/guide/getting_started/index.html#L195

The part of the example doesn't work, I will get an error

=ERROR REPORT==== 5-Nov-2014::23:44:47 === Error in process <0.161.0> on node '[email protected]' with exit value: {[{reason,undef},{mfa,{hello_handler,init,2}},{stacktrace,[{hello_handler,init,[{http_req,#Port<0.502>,ranch_tcp,keepalive,<0.161.0>,<<3 bytes>>,'HTTP/1.1',{{127,0,0,1},34886},<<9 bytes>>,undefined,8082,<<1 byte>>,undefined,<<0 bytes>>,[],[{<<4 bytes>>,<<14 bytes>>},{<<10 bytes>>,<<10 bytes>>},{<<6 bytes>>,<<74 bytes>>},{<<10 bytes>>,<<105 bytes>>},{<<15 bytes>>,<<17 bytes>>},{<<15 bytes>>,<<14 bytes>>},{<<6 bytes>>,<<53 bytes>>}],[],waiting,<<0 bytes>>,undefined,false,waiting...

if I follow this Getting Started page. I managed to get something working by following the cowboy/examples/hello_world source code, which is really different from the one in this Getting Started page,

Getting Started: handler logic in handle(Req, State=#state{}) -> DOESN'T WORK examples/hello_world: handler logic in init(Req, Opts) -> THIS WORKS

2. Not only that, the template-generated .erl file created from
   make new t=cowboy_http n=hello_handler
   has a behaviour cowboy_http_handler that prevents make from building.

I had to remove everything and follow exactly the example in cowboy/examples/ to have things working.

3. Apologies, I am just a beginner to Erlang so I totally don't know how to decipher the ERROR REPORT given in 1) above, but could anyone tell me what that means? (All that I know now is that I can copy and paste from the cowboy/example and things work, but I don't have even the slightest knowledge of what is actually the problem when I follow the Getting Started example.)

4. Lastly, could someone tell me how do I start Cowboy without having to make every time I code change my handler? I would like my development workflow to be: modify erl code, recompile just my changes and test (auto-reloading like django's development server is best, if anyone can tell me how to. If not, I am ok with manually compiling, but how to only re-compile the changed source?).

As it is now, having to build an entire release on small code changes is just too time-consuming. Maybe there is a much better way I did not discover (despite searching a lot)?

Thanks for this awesome open-source :)

(My system: Ubuntu 13.10 and Erlang R17.)

https://twitter.com/warianoguerra/status/714454227708469248/photo/1

Hello,
It would be nice to have a read next or previous link at the end in the official documentation of (Cowboy, Ranch, ...) at the end of the pages.

e.g.

I find it frustrating to go back and change pages, but hey, it's just a thought and small improvement, in any case thanks for everything ;)