[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-core-devel
Subject:    Re: KAction: kill all convenience methods
From:       Guillaume Laurent <glaurent () telegraph-road ! org>
Date:       2006-12-11 14:46:06
Message-ID: 200612111546.06417.glaurent () telegraph-road ! org
[Download RAW message or body]

On Monday 11 December 2006 05:11, Matt Rogers wrote:
>
> The purpose of convenience methods is to make it easier on the user to use
> a piece of API. How does removing these convenience methods affect the ease
> of use of the API?

By making it much easier to find what call you need to use.

> What about the other 5% of the use cases that aren't 
> well served by the normal version of the calls with default parameters?
> What are they supposed to do?

They write a bit more code.

> So far, I'm not convinced.

Try watching this talk (by a guy working at Google), very worthwhile : 

http://www.infoq.com/presentations/effective-api-design

-- 
Guillaume.
http://telegraph-road.org
[prev in list] [next in list] [prev in thread] [next in thread]