diff --git a/docs/en/migration-guides/release-5.x/5.2/system.rst b/docs/en/migration-guides/release-5.x/5.2/system.rst
index 1cf76ae4be..916ad605f3 100644
--- a/docs/en/migration-guides/release-5.x/5.2/system.rst
+++ b/docs/en/migration-guides/release-5.x/5.2/system.rst
@@ -11,4 +11,13 @@ Task Snapshot
 
 The Task Snapshot API has been made private due to a lack of a practical way for the API to be used from user code (the scheduler must be halted before the API can be called).
 
-As a result, the ``#include "freertos/task_snapshot.h"`` include path has been deprecated.
\ No newline at end of file
+.. only:: CONFIG_IDF_TARGET_ARCH_XTENSA
+
+    Xtensa
+    ------
+
+    A number of legacy include paths for Xtensa headers have been deprecated:
+
+    - ``#include "freertos/xtensa_api.h"`` is deprecated, please use ``#include "xtensa_api.h"`` instead.
+    - ``#include "freertos/xtensa_context.h"`` is deprecated, please use ``#include "xtensa_context.h"`` instead.
+    - ``#include "freertos/xtensa_timer.h"`` is deprecated, please use ``#include "xtensa_timer.h"`` instead.