From 656baa0fd1e0fb14c5c859033adebba42060cc29 Mon Sep 17 00:00:00 2001 From: "Xiaofei Cao (from Dev Box)" Date: Mon, 16 Mar 2026 14:41:06 +0800 Subject: [PATCH 1/5] Update deprecation_process.md with version_client.txt instructions Add a step to update eng/versioning/version_client.txt when the release version differs from the current-version during package deprecation. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- doc/deprecation_process.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/doc/deprecation_process.md b/doc/deprecation_process.md index 782cf9431c96..66de00a247a0 100644 --- a/doc/deprecation_process.md +++ b/doc/deprecation_process.md @@ -38,6 +38,15 @@ Clone the repository and update the following files of your package: > $ReplaceGuide for guidance on upgrading. Refer to our deprecation policy (https://aka.ms/azsdk/support-policies) for > more details. +- `eng/versioning/version_client.txt` if the release version differs from the `current-version` + (third field), update it to the version you are about to release. + For instance: + +```diff +- com.azure:azure-example;1.1.0;1.2.0-beta.1 ++ com.azure:azure-example;1.1.0;1.2.3 +``` + Do a PR targeting the `main` branch. Post your PR in our [channel for Java](https://teams.microsoft.com/l/channel/19%3a5e673e41085f4a7eaaf20823b85b2b53%40thread.skype/Language%2520-%2520Java?groupId=3e17dcb0-4257-4a30-b843-77f47f1d4121&tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47). You're responsible to fix any CI issues related to this PR, if any. From febca07b547f4362988dc38e09fc8dbefad25e0d Mon Sep 17 00:00:00 2001 From: "Xiaofei Cao (from Dev Box)" Date: Mon, 16 Mar 2026 15:13:44 +0800 Subject: [PATCH 2/5] Indent fenced code block under list item for proper GFM rendering Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- doc/deprecation_process.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/doc/deprecation_process.md b/doc/deprecation_process.md index 66de00a247a0..0f1994ebc96a 100644 --- a/doc/deprecation_process.md +++ b/doc/deprecation_process.md @@ -42,10 +42,10 @@ Clone the repository and update the following files of your package: (third field), update it to the version you are about to release. For instance: -```diff -- com.azure:azure-example;1.1.0;1.2.0-beta.1 -+ com.azure:azure-example;1.1.0;1.2.3 -``` + ```diff + - com.azure:azure-example;1.1.0;1.2.0-beta.1 + + com.azure:azure-example;1.1.0;1.2.3 + ``` Do a PR targeting the `main` branch. Post your PR in our [channel for Java](https://teams.microsoft.com/l/channel/19%3a5e673e41085f4a7eaaf20823b85b2b53%40thread.skype/Language%2520-%2520Java?groupId=3e17dcb0-4257-4a30-b843-77f47f1d4121&tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47). From 132f92a7f5850b47feaa3233f6f431af70c80377 Mon Sep 17 00:00:00 2001 From: "Xiaofei Cao (from Dev Box)" Date: Mon, 16 Mar 2026 15:29:45 +0800 Subject: [PATCH 3/5] Clarify version_client.txt wording and separate as repo-level file - Introduce repo-level section to distinguish from package-level files - Replace ambiguous 'update it' with explicit 'set the current-version' - Remove redundant phrasing Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- doc/deprecation_process.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/doc/deprecation_process.md b/doc/deprecation_process.md index 0f1994ebc96a..54a65449e351 100644 --- a/doc/deprecation_process.md +++ b/doc/deprecation_process.md @@ -38,8 +38,10 @@ Clone the repository and update the following files of your package: > $ReplaceGuide for guidance on upgrading. Refer to our deprecation policy (https://aka.ms/azsdk/support-policies) for > more details. -- `eng/versioning/version_client.txt` if the release version differs from the `current-version` - (third field), update it to the version you are about to release. +Additionally, update the following repo-level file if needed: + +- `eng/versioning/version_client.txt` set the `current-version` (third field) to the release + version if they differ. For instance: ```diff From 2dcdf11c52c0b0f0e630384d15cc0f4d1d6b16f3 Mon Sep 17 00:00:00 2001 From: "Xiaofei Cao (from Dev Box)" Date: Mon, 16 Mar 2026 17:19:24 +0800 Subject: [PATCH 4/5] Update version_client.txt diff example to use more realistic versions Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- doc/deprecation_process.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/deprecation_process.md b/doc/deprecation_process.md index 54a65449e351..6ff154801b59 100644 --- a/doc/deprecation_process.md +++ b/doc/deprecation_process.md @@ -45,8 +45,8 @@ Additionally, update the following repo-level file if needed: For instance: ```diff - - com.azure:azure-example;1.1.0;1.2.0-beta.1 - + com.azure:azure-example;1.1.0;1.2.3 + - com.azure:azure-example;1.0.0;1.1.0-beta.1 + + com.azure:azure-example;1.0.0;1.0.1 ``` Do a PR targeting the `main` branch. Post your PR in our [channel for Java](https://teams.microsoft.com/l/channel/19%3a5e673e41085f4a7eaaf20823b85b2b53%40thread.skype/Language%2520-%2520Java?groupId=3e17dcb0-4257-4a30-b843-77f47f1d4121&tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47). From f9ed4e24d707cc59e8cf02f37756db56903e88d4 Mon Sep 17 00:00:00 2001 From: "Xiaofei Cao (from Dev Box)" Date: Mon, 16 Mar 2026 17:21:11 +0800 Subject: [PATCH 5/5] Align CHANGELOG example version to 1.0.1 for consistency Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- doc/deprecation_process.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/deprecation_process.md b/doc/deprecation_process.md index 6ff154801b59..dfb178147058 100644 --- a/doc/deprecation_process.md +++ b/doc/deprecation_process.md @@ -24,7 +24,7 @@ Clone the repository and update the following files of your package: - `CHANGELOG.md` add a new version with the current date and the same disclaimer. For instance: -> ## 1.2.3 (2023-04-03) +> ## 1.0.1 (2023-04-03) > > Please note, this package has been deprecated and will no longer be maintained after $EOLDate. We encourage you to > upgrade to the replacement package, $Replacement, to continue receiving updates. Refer to the migration guide