diff --git a/docs/src/pages/migrations.md b/docs/src/pages/migrations.md
index dcafbd831..cdcbc3750 100644
--- a/docs/src/pages/migrations.md
+++ b/docs/src/pages/migrations.md
@@ -16,6 +16,7 @@ This will be the next version of Woodpecker.
   - `CI_PIPELINE_FINISHED` as empty during execution
   - `CI_PIPELINE_STATUS` was always `success`
   - `CI_STEP_STATUS` was always `success`
+- `CI_COMMIT_BRANCH` now always returns the source branch, even for pull requests (previously it returned the target branch)
 - Set `/woodpecker` as default workdir for the **woodpecker-cli** container
 - Secret filters for plugins now check against tag if specified
 - Compatibility mode of deprecated `pipeline:`, `platform:` and `branches:` pipeline config options are now removed and pipeline will now fail if still in use.