RFR: Fixed backing out a backport

[Kevin Rushforth]

On Thu, 9 Oct 2025 21:11:28 GMT, Jesper Wilhelmsson <jwilhelm at openjdk.org> wrote:

> Backing out a change was updated to not use sub-tasks, but the similar case of backing out a backport was missed.

You have the direction of the causes / caused-by links reversed.

src/guide/testing-the-jdk.md line 323:

> 321:      * Create a new issue of type [Bug]{.jbs-value}. This new issue will be the backout-issue **(B)**.
> 322:      * Use the same summary as **(O)** prefixed with `[BACKOUT]`.
> 323:      * Add a _causes_ link from **(B)** to **(O)**.

This should be a _caused-by_ link from (B) to (O), or conversely, a _causes_ link from (O) to (B). The direction is important.

These are the links we want to end up with:

* (B) is caused-by (O)
* (O) causes (B)

src/guide/testing-the-jdk.md line 327:

> 325:      * Use the investigation issue **(I)** for the backout. (Don't create a new **(B)**.)
> 326:      * Change summary of **(I)** to the same as **(O)** and prefix with `[BACKOUT]`.
> 327:      * Add a _causes_ link from **(I)** and **(O)**.

That should be "from...to" (not "...and")

Also, that should be: Add _caused-by_ link from (I) to (O), or conversely, a _causes_ link from (O) to (I)?

src/guide/testing-the-jdk.md line 399:

> 397:      * Create a new issue of type [Bug]{.jbs-value}. This new issue will be the backout-issue **(B)**.
> 398:      * Use the same summary as **(M)** prefixed with `[BACKOUT BACKPORT]`.
> 399:      * Add a _causes_ link from **(B)** to **(O)**.

_caused-by_ link from (B) to (O)

src/guide/testing-the-jdk.md line 403:

> 401:      * Use the investigation issue **(I)** for the backout. (Don't create a new **(B)**.)
> 402:      * Change summary of **(I)** to the same as **(M)** and prefix with `[BACKOUT BACKPORT]`.
> 403:      * Add a _causes_ link from **(I)** to **(O)**.

_caused-by_ link from (I) to (O)

-------------

PR Review: https://git.openjdk.org/guide/pull/160#pullrequestreview-3320715690
PR Review Comment: https://git.openjdk.org/guide/pull/160#discussion_r2418012883
PR Review Comment: https://git.openjdk.org/guide/pull/160#discussion_r2418015640
PR Review Comment: https://git.openjdk.org/guide/pull/160#discussion_r2418018651
PR Review Comment: https://git.openjdk.org/guide/pull/160#discussion_r2418019205