docs(java-client): add announcement of zeebe java client deprecation

[nicpuppa]

Description

Add an announcement regarding Zeebe Java Client deprecation in 8.7, to be replaced by Camunda Client

When should this change go live?

• This is a bug fix, security concern, or something that needs urgent release support.
• This is already available but undocumented and should be released within a week.
• This on a specific schedule and the assignee will coordinate a release with the DevEx team. (apply hold label or convert to draft PR)
• This is part of a scheduled alpha or minor. (apply alpha or minor label)
• There is no urgency with this change and can be released at any time.

PR Checklist

• My changes are for an already released minor and are in /versioned_docs directory.
• My changes are for the next minor and are in /docs directory (aka /next/).

• My changes require an Engineering review, and I've assigned the Engineering DRI or delegate.
• My changes require a technical writer review, and I've assigned @camunda/tech-writers as a reviewer.

closes: #4047

[github-actions]

👋 🤖 🤔 Hello! Did you make your changes in all the right places?

These files were changed only in docs/. You might want to duplicate these changes in versioned_docs/version-8.5/.

• docs/apis-tools/java-client/index.md
• docs/reference/announcements.md

You may have done this intentionally, but we wanted to point it out in case you didn't. You can read more about the versioning within our docs in our documentation guidelines.

[christinaausley]

@nicpuppa I see this is still in draft, is that because you have more changes coming, or this is most of it and you're ready for review? 😄

[nicpuppa]

@nicpuppa I see this is still in draft, is that because you have more changes coming, or this is most of it and you're ready for review? 😄

Hey @christinaausley , I drafted this PR because we need to discuss if we took the right approach for the client. Later today I'm syncing with the team on this 🤞

[tmetzke]

As described in the latest decision, let's rewrite the announcement, stating that the Zeebe Client will be replaced by the more general Camunda Client with 8.7.

[tmetzke]

The announcement in 8.6 will only be a heads-up for 8.7, so it should use the future tense. Plus, some things we don't know yet so let's not promise them.

[nicpuppa]

@tmetzke this is still the old PR 🤣 sorry for pinging you, I'm updating the announcement

[nicpuppa]

Hey @christinaausley this PR is ready to be reviewed 👍

[christinaausley]

Relates to camunda/camunda#19479.

[christinaausley]

Non-blocking, but would it be worth adding a brief note in https://docs.camunda.io/docs/apis-tools/java-client/ as well?

Looks like there are no "breaking" changes with this, but let me know if this changes 👍

[akeller]

@tmetzke @megglos can we get a review from either of you for this?

I also second what @christinaausley said.

Will we have a blog or forum content on this topic?

[tmetzke]

@tmetzke @megglos can we get a review from either of you for this?

I also second what @christinaausley said.

Will we have a blog or forum content on this topic?

A heads-up note there that this will become the Camunda Client with 8.7 would be nice, I agree, good idea, @christinaausley 👍
It can link back to the announcement for further information.

No blog or forum post planned so far. A blog entry is too much here for the change from Zeebe Client to Camunda Client. Regarding the overall theme for 8.7 from component REST APIs to one consolidated C8 REST API and accordingly from component clients to one consolidated Camunda Client would definitely be worth a blog post. /cc @aleksander-dytko for visibility, not sure if anything is already planned in that direction.

[nicpuppa]

Hey @christinaausley @tmetzke I wrote an heads up as suggested, please have a look 💪

[tmetzke]

👍 Looks good to me 🚀

[christinaausley]

🚀