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

[Andy Goryachev]

On Wed, 14 Jan 2026 18:45:00 GMT, John Hendrikx <jhendrikx 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?

yep.  try BorderPane page in the monkey tester, set the node orientation to RTL

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

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