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

[John Hendrikx]

On Wed, 14 Jan 2026 18:47:31 GMT, Andy Goryachev <angorya at openjdk.org> wrote:

>> 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

I retract the comment.  This is certainly well hidden.  I'm not sure actually if mirroring literally everything is what a RTL world really desires, but apparently that's the case.

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

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