pierrejeambrun commented on code in PR #35628: URL: https://github.com/apache/airflow/pull/35628#discussion_r1394282219
########## dev/README_RELEASE_AIRFLOW.md: ########## @@ -1005,29 +1005,27 @@ File `airflow/config_templates/config.yml` contains documentation on all configu After releasing airflow core, we need to check if we have to follow up with API clients release. -Clients are released in a separate process, with their own vote mostly because their version can mismatch the core release. -ASF policy does not allow to vote against multiple artifacts with different versions. +Clients are released in a separate process, with their own vote. -### API Clients versioning policy - -For major/minor version release, always release new versions of the API clients. +Clients can be found here: - [Python client](https://github.com/apache/airflow-client-python) - [Go client](https://github.com/apache/airflow-client-go) -For patch version release, you can also release patch versions of clients **only** if the patch is relevant to the clients. -A patch is considered relevant to the clients if it updates the [openapi specification](https://github.com/apache/airflow/blob/main/airflow/api_connexion/openapi/v1.yaml). -There are other external reasons for which we might want to release a patch version for clients only, but they are not -tied to an airflow release and therefore out of scope. +### API Clients versioning policy + +Clients and Core versioning are completely decoupled. Clients also follow SemVer and are updated when core introduce changes relevant to the clients. +Most of the time, if the [openapi specification](https://github.com/apache/airflow/blob/main/airflow/api_connexion/openapi/v1.yaml) has +changed, clients need to be released. -To determine if you should also release API clients you can run: +To determine if you should release API clients, you can run: Review Comment: Good idea, done. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
