From 053b1bcd018361d788a9164922ce4bf78b7d2db2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yann=20C=C3=A9bron?= <yann.cebron@jetbrains.com>
Date: Wed, 27 Sep 2023 17:58:03 +0200
Subject: [PATCH] api_changes_list_2023.md: commons-lang/collections library
 removal

---
 reference_guide/api_changes_list_2023.md | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/reference_guide/api_changes_list_2023.md b/reference_guide/api_changes_list_2023.md
index 5a5114249..d05b20ffb 100644
--- a/reference_guide/api_changes_list_2023.md
+++ b/reference_guide/api_changes_list_2023.md
@@ -1,7 +1,7 @@
-<!-- Copyright 2000-2023 JetBrains s.r.o. and other contributors. Use of this source code is governed by the Apache 2.0 license that can be found in the LICENSE file. -->
-
 # Incompatible Changes in IntelliJ Platform and Plugins API 2023.*
 
+<!-- Copyright 2000-2023 JetBrains s.r.o. and other contributors. Use of this source code is governed by the Apache 2.0 license that can be found in the LICENSE file. -->
+
 <!--
 Before documenting a breaking API change, please make sure that the change cannot be avoided in an alternative way.
 
@@ -72,6 +72,11 @@ NOTE: Entries not starting with code quotes (`name`) can be added to document no
 
 ### IntelliJ Platform 2023.3
 
+Removal of commons-lang2 and commons-collections libraries
+: _commons-lang2_ library is going to be removed, a temporary compatibility layer (marked with `@Deprecated(forRemoval = true)` to highlight usages) is bundled.
+Please consider migrating to either _commons-lang3_ or _commons-text_ libraries and bundle them with your plugin.
+Library _commons-collections_ is going to be removed.
+
 JsonPath library unbundled
 : Bundle it [explicitly](https://youtrack.jetbrains.com/issue/IDEA-328219) with your plugin.