Galène videoconferencing server discussion list archives
 help / color / mirror / Atom feed
From: Dianne Skoll <>
Subject: [Galene] API versioning (was Re: Re: API documentation)
Date: Wed, 10 Apr 2024 20:02:02 -0400	[thread overview]
Message-ID: <> (raw)
In-Reply-To: <>

On Wed, 10 Apr 2024 22:47:36 +0200
"Gabriel Kerneis" <> wrote:

> The /0/ is intriguing, but maybe just because I'm not used to REST
> API design. I'd add a sentence explaining its versioning purpose
> anyway.

It was I who suggested a versioned API.  My thinking was that if there's
some drastic change to the API, the version number could be incremented,
but (where feasible) the old API could still be supported so older API
clients would still work.

It may turn out to be completely unnecessary.  But still, the cost of doing
it and not needing it is small, whereas the cost of not doing it and
then discovering it is needed is large.



  parent reply	other threads:[~2024-04-11  0:02 UTC|newest]

Thread overview: 5+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2024-04-10 19:40 [Galene] API documentation Juliusz Chroboczek
2024-04-10 20:47 ` [Galene] " Gabriel Kerneis
2024-04-10 23:09   ` Juliusz Chroboczek
2024-04-11  0:02   ` Dianne Skoll [this message]
     [not found]   ` <171279372600.1000.262671797887854827@gauss.local>
2024-04-11 12:55     ` [Galene] Re: API versioning (was Re: Re: API documentation) Juliusz Chroboczek

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:

  List information:

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \ \ \ \
    --subject='[Galene] API versioning (was Re: Re: API documentation)' \

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox