Commit fe3c0c48ae for woocommerce
commit fe3c0c48ae9dc171075642693756f22fabc4c846
Author: Alba Rincón <albarin@users.noreply.github.com>
Date: Wed Dec 10 15:33:08 2025 +0100
Improve release documentation (#62282)
* Improve release documentation
* Fix broken link
diff --git a/.linear/release-kickoff-beta.md b/.linear/release-kickoff-beta.md
index c67c613e7a..6fe51fb027 100644
--- a/.linear/release-kickoff-beta.md
+++ b/.linear/release-kickoff-beta.md
@@ -5,6 +5,7 @@ This issue tracks the progress of a single WooCommerce core plugin release itera
## Version being released {RELEASE_VERSION}-beta.{BETA_PATCH_VERSION}
The following details are copied from the official [Building and Publishing guide](https://developer.woocommerce.com/docs/contribution/releases/building-and-publishing/). Please check it to make sure these instructions haven't become out of date.
+Check the [Release Troubleshooting & Recovery](https://developer.woocommerce.com/docs/contribution/releases/troubleshooting/) page for any issues you may encounter.
## Pre-Checks
diff --git a/.linear/release-kickoff-patch.md b/.linear/release-kickoff-patch.md
index ba0fad551f..171e995954 100644
--- a/.linear/release-kickoff-patch.md
+++ b/.linear/release-kickoff-patch.md
@@ -5,6 +5,7 @@ This issue tracks the progress of a single WooCommerce core plugin release itera
## Version being released {RELEASE_VERSION}.{PATCH_VERSION}
The following details are copied from the official [Building and Publishing guide](https://developer.woocommerce.com/docs/contribution/releases/building-and-publishing/). Please check it to make sure these instructions haven't become out of date.
+Check the [Release Troubleshooting & Recovery](https://developer.woocommerce.com/docs/contribution/releases/troubleshooting/) page for any issues you may encounter.
## Pre-Checks
diff --git a/.linear/release-kickoff-rc.md b/.linear/release-kickoff-rc.md
index 5b1605654e..e2728360a4 100644
--- a/.linear/release-kickoff-rc.md
+++ b/.linear/release-kickoff-rc.md
@@ -5,6 +5,7 @@ This issue tracks the progress of a single WooCommerce core plugin release itera
## Version being released {RELEASE_VERSION}-RC.{RC_PATCH_VERSION}
The following details are copied from the official [Building and Publishing guide](https://developer.woocommerce.com/docs/contribution/releases/building-and-publishing/). Please check it to make sure these instructions haven't become out of date.
+Check the [Release Troubleshooting & Recovery](https://developer.woocommerce.com/docs/contribution/releases/troubleshooting/) page for any issues you may encounter.
## Pre-Checks
diff --git a/docs/apis/store-api/extending-store-api/extend-store-api-add-data.md b/docs/apis/store-api/extending-store-api/extend-store-api-add-data.md
index 795138f4e3..ebac1040f7 100644
--- a/docs/apis/store-api/extending-store-api/extend-store-api-add-data.md
+++ b/docs/apis/store-api/extending-store-api/extend-store-api-add-data.md
@@ -12,7 +12,7 @@ ExtendSchema offers the possibility to add contextual custom data to Store API e
You can use ExtendSchema by registering a couple of functions, `schema_callback` and `data_callback` on a specific endpoint namespace. ExtendSchema will call them at execution time and will pass them relevant data as well.
-This example below uses the Cart endpoint, [see passed parameters.](./available-endpoints-to-extend.md#wcstorecart)
+This example below uses the Cart endpoint, [see passed parameters.](./available-endpoints-to-extend.md)
**Note: Make sure to read the "Things to consider" section below.**
diff --git a/docs/contribution/releases/troubleshooting.md b/docs/contribution/releases/troubleshooting.md
index 8140c78aaf..7109a833c7 100644
--- a/docs/contribution/releases/troubleshooting.md
+++ b/docs/contribution/releases/troubleshooting.md
@@ -19,6 +19,13 @@ This page provides guidance for troubleshooting and recovering from issues that
⚠️ _Do not re-run any workflows until you understand the cause of the failure._ Re-running without fixing the root issue can make things more complicated.
+### CI is failing on a release-related PR
+
+During the release process, you may encounter CI test failures on release-related PRs. These failures sometimes occur because test fixes were merged to trunk but not backported to the release branch before it was cut.
+
+1. **Identify the cause**: Check if the failing tests pass on trunk. If they do, the fix likely needs to be backported.
+2. **Backport test fixes**: If possible, [backport](/docs/contribution/releases/backporting) the relevant test fixes from trunk to the release branch, then re-run the CI workflow.
+3. **Handle complex cases**: If backporting isn't possible due to dependencies or the cause isn't clear, document what you've found and ask for help in the release Slack channel. The "Heart of Gold - Flux" team can assist with resolving CI issues that block release work.
### Something looks wrong in the final release ZIP. Can I start over? {#can-i-start-over-id}