launchpad-dev team mailing list archive

[curtis Hovey <curtis.hovey@xxxxxxxxxxxxx>]

On 03/06/2012 09:22 PM, Ian Booth wrote:
> Hi fellow Launchpad hackers
> 
> https://dev.launchpad.net/APIServices

I think we could have success criteria that is measurable. I hope and
believe that API Services will

1. Reduce the lines of code need to get data from launchpad to the
browser. A service will provide the needed data with fewer lines of
python and JavaScript code when competing implementations are examined.
I believe the the fewer lines of code will be self-evident to any
experienced developer -- we do not need a competing implementation, but
if we debate this success point, I think we might question if services
need mode time to develop.

2. Fewer Web requests and DB queries to get the needed data because
there are fewer objects and entities that require individual calls. We
expect the API services to provide set-based ways to work with collections.

3. Reduced maintenance cost because there are fewer parts that need
update when one part's API/contract changes. We fix a lot of JavaScript
and Python because what we hope will be a refactoring of internal code
reveals itself to be an internal and maybe external API change.

4. Versioning is easier because the service is a facade for objects with
more mutable APIs. This is also a maintenance savings that we also pass
on to Launchpad users.




-- 
Curtis Hovey
http://launchpad.net/~sinzui

Attachment: signature.asc
Description: OpenPGP digital signature