[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