[Tools-discuss] Re: documents by WG --- RFCs and related documents -- are there APIs

[Jennifer Richards <[e-mail]>]

On 2025-07-30 12:19 PM, Tom Pusateri wrote:
> Hopefully, the v1 API won’t change. Isn’t that the point of versioning? If the models were to change, then you should define a new v2 API so that you don’t break all the existing v1 users.

Assuming tastypie, which is what provides the v1 API, remains stable, 
the structure of that API won't change. That API is, and has always been 
as far as I'm aware, a thin layer over (almost all of) the Datatracker's 
internal models. For better or worse, the meaningful version number for 
that API is the datatracker's version number.

Introducing the kind of long-term stable API you're getting at would be 
a substantial new project. It's possible, but it's a much bigger ask 
than just bumping a version number on the API.

jennifer