On Feb 27, 2009, at 1:07 PM, Eric Gerlach wrote:
>
> On Fri, Feb 27, 2009 at 12:47:36PM -0600, Luke Kanies wrote:
>> Your points are definitely valid. This is the closest (and best)
>> discussion I've found:
>>
>> http://stackoverflow.com/questions/389169/best-practices-for-api-versioning
>
> Actually, that's a really good treatment of the subject.
>
>> At this point, I think it's reasonable to put the api versions into
>> parameters. That way the default behaviour is always the latest
>> version, and you can start using the api without knowing api version
>> numbers specifically, but you've always got the ability to use
>> different versions, too.
>>
>> Does that work?
>
> I don't really care all that much personally. If I get around to
> using the
> Puppet API, I'll use it in whatever form it takes. It just seemed
> to me to be
> a bit incongrous that this thread started by discussing adding a
> parameter to
> the beginning of the URI, and then got into adding a version to the
> end.
Well, frankly, version numbers won't make it into 0.25 anyway, and
there's nothing in the current code that prohibits us from adding them
later. So, we can keep the discussion open on them, and take it up
again when we plan on actually tackling the problem.
The big reason I thought about using parameters was just that we might
need to version the overall API (the split between environment,
resource type, and resource key) separately from the resource type API
(any formatting within the key). This is probably doable with
parameters, but starts to get ridiculous including the info in the
actual URI.
>
> My two cents are Canadian, after all, so you have to de-value them
> by the
> exchange rate :-)
These days we Yanks aren't exactly in a position to brag. Given that
I just lost $2k in currency conversion because client took a few extra
months to pay, this is especially poignant for me. :/
--
One of the Ten Commandments for Technicians:
(7) Work thou not on energized equipment, for if thou dost, thy
fellow workers will surely buy beers for thy widow and
console her in other ways.
---------------------------------------------------------------------
Luke Kanies | http://reductivelabs.com | http://madstop.com
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"Puppet Developers" group.
To post to this group, send email to puppet-dev@googlegroups.com
To unsubscribe from this group, send email to
puppet-dev+unsubscr...@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/puppet-dev?hl=en
-~----------~----~----~----~------~----~------~--~---
