<div dir="ltr">I followed the cowboy getting started tutorial and found it very reassuring to be taken all the way to generating a release. I am pretty sure I could build on that sample and actually create something that could be used. I think there is a lot of value in that. Personally I find tweet sized getting started examples very unsatisfactory and prefer something that gives and indication of workflow as well as the language. Hipsters may feel differently.<div>
<br></div><div>Karl</div></div><div class="gmail_extra"><br><br><div class="gmail_quote">On 19 June 2014 00:30, Loïc Hoguin <span dir="ltr"><<a href="mailto:essen@ninenines.eu" target="_blank">essen@ninenines.eu</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="">On 06/18/2014 10:22 PM, Kenneth Lundin wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
That is what I meant, you are using a more complex setup with Erlang in<br>
order to get more features. So the comparision with other languages<br>
"simple setup" is not fair.<br>
</blockquote>
<br></div>
The setup is more complex but the way we get there isn't. Have you read the getting started chapter[1]? The release part is smaller than it would take to explain "erl -run" or "erl -s": we don't have to write extra code for it, we don't have to manually setup paths, we don't have to deal with reltool, and so on. It's literally "create relx.config, put this in it, run make again". Bam you got a release. That part can't get any simpler.<br>

<br>
Erlang *is* more complex to use than many other languages (it is still simpler than C, C++ and the like though). Either you do things manually by downloading dependencies manually and such, or you use a build system like <a href="http://erlang.mk" target="_blank">erlang.mk</a> (or rebar) to automate things which requires you to create an OTP application.<br>

<br>
Because <a href="http://erlang.mk" target="_blank">erlang.mk</a> automates the use of relx to build releases it is actually simpler to make a release than manually setup paths and whatnot. We just have to create the one file! We don't deal with reltool here, creating the release is *really* easier than not.<br>

<br>
There's no simpler alternative to all that in the Erlang ecosystem. We will be able to make it a little simpler by having templates instead of making the user copy things, but the getting started chapter will not go down in length dramatically because of this.<br>

<br>
We could remove all explanations to make it perhaps half the size it currently is, but then we removed all explanations. It's a chapter about getting started, it's supposed to provide initial pointers to users, not just get them to run an example and then ask themselves "now what?". We have actual examples for people that want that already.<br>

<br>
I am not even sure what triggers all these good comments about the nodejs documentation. Sure it has a 6 lines and 1 command example on its front page. There's no denying that. Then what? A link to API docs. I have *no* idea how people manage to learn how to use it. Surely by using other resources than these, because while I'm confident I could run the front page example quickly, I am also confident that's about all I could do with it for a rather long time until I manage to figure out how to do anything meaningful, if I were to only use the official docs.<br>

<br>
[1] <a href="http://ninenines.eu/docs/en/cowboy/HEAD/guide/getting_started/" target="_blank">http://ninenines.eu/docs/en/<u></u>cowboy/HEAD/guide/getting_<u></u>started/</a><div class="im HOEnZb"><br>
<br>
-- <br>
Loïc Hoguin<br>
<a href="http://ninenines.eu" target="_blank">http://ninenines.eu</a><br></div><div class="HOEnZb"><div class="h5">
______________________________<u></u>_________________<br>
erlang-questions mailing list<br>
<a href="mailto:erlang-questions@erlang.org" target="_blank">erlang-questions@erlang.org</a><br>
<a href="http://erlang.org/mailman/listinfo/erlang-questions" target="_blank">http://erlang.org/mailman/<u></u>listinfo/erlang-questions</a><br>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br><b>Karl Nilsson</b><div>twitter: @kjnilsson</div><div>blog: <a href="http://coderkarl.wordpress.com/" target="_blank">coderkarl.wordpress.com</a></div>

</div>