From: Dianne Skoll <dianne@skoll.ca>
To: galene@lists.galene.org
Subject: [Galene] API versioning (was Re: Re: API documentation)
Date: Wed, 10 Apr 2024 20:02:02 -0400 [thread overview]
Message-ID: <20240410200202.74875148@gato.skoll.ca> (raw)
In-Reply-To: <32abf60e-fc7c-45cc-81d4-2c08feb16a04@app.fastmail.com>
On Wed, 10 Apr 2024 22:47:36 +0200
"Gabriel Kerneis" <gabriel@kerneis.info> 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.
Regards,
Dianne.
next prev 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:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://lists.galene.org/postorius/lists/galene.lists.galene.org/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20240410200202.74875148@gato.skoll.ca \
--to=dianne@skoll.ca \
--cc=galene@lists.galene.org \
--subject='[Galene] API versioning (was Re: Re: API documentation)' \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* 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