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

[Andy Goryachev]

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

> 203:  * {@link javafx.scene.Node#nodeOrientationProperty() Node.nodeOrientation} properties.
> 204:  * A value set on a {@code Scene} applies to its root, and a value set on any {@code Node} applies to that
> 205:  * node and its descendants. It is effectively left-to-right by default, but can be right-to-left depending

it is effectively -> it is typically?

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

> 207:  * scene graph, descendants of the scene or node will inherit the specified orientation.
> 208:  * <p>
> 209:  * For layout containers, the effective orientation determines how children are ordered and how horizontal

It might be just me, but it feels like very long and hard to understand.  Could we just say that for historic reasons, left/right should be interpreted as leading/trailing?  and give an example: "left" in RTL mode appears on the right side, sorry about that?

what do you think?

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

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