RFR: 8375243: Improve javafx.scene.layout package documentation

[John Hendrikx]

On Wed, 14 Jan 2026 03:40:10 GMT, Michael Strauß <mstrauss at openjdk.org> wrote:

> This PR adds a paragraph about layout orientation to the `javafx.scene.layout` package documentation.

modules/javafx.graphics/src/main/java/javafx/scene/layout/package-info.java line 214:

> 212:  * the first child usually appears at the right edge and subsequent children flow to the left. Containers that
> 213:  * expose named regions keep the same API, but the visual placement is mirrored in right-to-left mode.
> 214:  * For example, the {@code left} and {@code right} regions of {@link javafx.scene.layout.BorderPane BorderPane}

Hm, I didn't know that in the RTL world, the words "left" and "right" change meaning.  I checked `BorderPane`, I can't find any evidence for this claim.  Is this really the case?

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

PR Review Comment: https://git.openjdk.org/jfx/pull/2035#discussion_r2691622120