Re: [Elementary-dev-community] Developer documentation (was: Google Summer of Code Ideas)

2014-02-22 Thread Daniel Foré
Marco, It's been a while, but there are comments on the doc. I remember there being a lot of inappropriate things from a design perspective. But since that time we've also deprecated or changed a lot of stuff in granite, so I have no idea how relevant it even is anymore. Your best granite r

Re: [Elementary-dev-community] Developer documentation (was: Google Summer of Code Ideas)

2014-02-22 Thread marco benzi
Daniel, could you elaborate on why it was the wrong way? I discovered that doc with this thread and was tempted to follow some points, specially with Granite.  Cheers, Marco - On Sat, Feb 22, 2014 at 5:59 PM, Daniel Foré wrote: > Completely disagree. I've had multiple people say that it's th

Re: [Elementary-dev-community] Developer documentation (was: Google Summer of Code Ideas)

2014-02-22 Thread Daniel Foré
Completely disagree. I've had multiple people say that it's the best documentation they've ever read and I think it's the only existing end-to-end documentation that shows you how to build and package a simple app in all of FOSS. Yes it's incomplete, but it sets a strong foundation and actuall

[Elementary-dev-community] Developer documentation (was: Google Summer of Code Ideas)

2014-02-22 Thread Sergey "Shnatsel" Davidoff
Hey guys, So I've checked out the current documentation in the website again and turns out it's quite useless. In addition to all the flaws I've already listed (quoted below for your convenience), it has no intro to Granite.Application or our widgets - in fact, it doesn't even mention Granite! All