Skip to content

Update deprecation_process.md with version_client.txt instructions #48426

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
XiaofeiCao merged 5 commits into from
Mar 17, 2026
Merged

Update deprecation_process.md with version_client.txt instructions #48426

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
656baa0
Update deprecation_process.md with version_client.txt instructions
XiaofeiCao Mar 16, 2026
febca07
Indent fenced code block under list item for proper GFM rendering
XiaofeiCao Mar 16, 2026
132f92a
Clarify version_client.txt wording and separate as repo-level file
XiaofeiCao Mar 16, 2026
2dcdf11
Update version_client.txt diff example to use more realistic versions
XiaofeiCao Mar 16, 2026
f9ed4e2
Align CHANGELOG example version to 1.0.1 for consistency
XiaofeiCao Mar 16, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 12 additions & 1 deletion doc/deprecation_process.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -38,6 +38,17 @@ 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.

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
- 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).

You're responsible to fix any CI issues related to this PR, if any.
Expand Down