Deprecated Classes and Functions - Listing and Forward notice?

Our dev team are having issues that we have developed on functions or classes that are now being deprecated. When I asked for a list the team are telling me that it is commented in the code. This is causing us unplanned work at refresh points and lack of visibility to the project management team (until it is too late and causing delays)

Is there any way to get a Deprecated and planned deprecation list so that we can assess the impact to our planning?

Thanks

Environment

Answers

I can't really answer from a planned deprecation point of view - might need someone from Kentico to elaborate on that.

But for existing, or newly deprecated APIs, the changelog includes recommendations on how to approach replacing/updating these APIs with other APIs.

I understand Kentico are looking to improve the comments in the codebase too, to give more guidance in the comments on how to approach the deprecations and allow AI tooling to help with applying them.

Accepted answer

We don't have a list of APIs we plan to deprecate today, because deprecation is not removal - deprecation is a plan to remove.

When we deprecate APIs it's because they were never intended to be public to begin with or a feature is being removed from the product entirely (e.g. media libraries) with a replacement (e.g. Content hub and content item assets).

If your team relies heavily on an API that we deprecate, please let us know by giving us product feedback. Tell us:

  • Your business case for using the API (what type of project feature it enables)
  • Other APIs or features you tried to use to accomplish the same goal

This feedback helps us understand what type of replacement API we could design or how we could enable the same use case with a new or updated product feature.

As Liam mentioned, deprecated APIs are listed in the changelog. If we have a simple clear replacement, it will be listed there.

We typically remove deprecated APIs during a major version change, and historically we've had about one of these each year around December.

When updating your Xperience projects to the latest Refresh, have an AI agent review the build output for deprecation warnings, search the changelog for details about the deprecation, and then write a short report explaining the impacted areas of your project and how to resolve the warnings. In my experience, the agent can typically also resolve the build warning.

Thanks Sean and Liam. The December guidance is great and we will use the business case option if we need to.

To response this discussion, you have to login first.