[DOCS] Add packaging breaking change
@@ -29,6 +29,36 @@ Similarly, the `suggest` index metric on the `indices` metric on the nodes stats
API has provided a response containing only an empty object since 5.0.0. In
6.3.0 this metric has been deprecated.
+[float]
+[[breaking_63_packaging_changes]]
+=== Packaging changes
+
+Starting with version 6.3, all of the {xpack} features ship with the default
+distribution of {es}. You no longer need to install {xpack} separately.
+
+[float]
+==== Deprecation of the `x-pack` configuration directory
+
+In 6.2 and earlier releases, the
+{stack-ov}/security-files.html[security configuration files], such as the
+`log4js.properties`, `role_mapping.yml`, `roles.yml`, `users`, and `users_roles`
+files, were located in an `x-pack` directory within the
+<<config-files-location,config directory>>.
+
+Starting in 6.3, the security configuration files are located directly in the
+config directory.
+
+IMPORTANT: If you upgraded to 6.3, your old security configuration files still
+exist in an `x-pack` folder. That path is deprecated, however, and you should
+move your files out of that folder. There is a known problem where the files in
+the old path are disregarded in favor of the files in the new path:
+{pull}/33688[#33688]. For more information, see
+{stack-ov}/trb-security-path.html[Failures due to relocation of the configuration files].
+
+Settings such as `files.role_mapping` now default to
+`ES_PATH_CONF/role_mapping.yml`. If you do not want to use the default locations,
+you must update the settings appropriately. See <<security-settings>>.
+
[float]
[[breaking_63_plugins_changes]]
=== Plugins changes
