[erlang-questions] I need some advices for a framework I'm doing

Loïc Hoguin essen@REDACTED
Mon Aug 24 23:45:05 CEST 2015


On 08/24/2015 10:20 PM, Ivan Carmenates Garcia wrote:
> Hi everyone, I am making a little framework for cowboy, but in general
> what I need is some advices regards final looking, i.e.:

OK I am a bit lost on everything you explained so allow me to give some 
generic advice:

* Make it work
* Start making apps with it
* Notice everything inefficient in how you now write apps
* Update your framework
* Repeat

Practice makes perfect. Add a little of looking at how everyone else 
does things in the mix to get ideas; sometimes you will notice something 
is bad in your framework but have no idea how to make it better, that's 
why you need to look elsewhere. Sometimes the idea might come from a 
completely unrelated source.

A few more things:

* Keep it simple and explicit
* Focus on the use cases that benefit the majority of users
* Choose good, short names
* Write a user guide when things stabilize

On the last point, you want the guide separate from code entirely 
because this forces you to think about how you really use it rather than 
just documenting functions or modules one after another. Think of it 
like writing a book, except the only role of this book is to explain to 
others *what* they can do with your framework and *why* they will do 
things that way.

Once you get there, you should have a pretty good product, and you'll 
most likely have gotten a ton of users along the way.

Cheers,

-- 
Loïc Hoguin
http://ninenines.eu
Author of The Erlanger Playbook,
A book about software development using Erlang



More information about the erlang-questions mailing list