modules/graphics/src/main/java/javafx/scene/Scene.java

@@ -164,10 +164,15 @@
  * size based on the preferred size of its content. If only one dimension is specified,
  * the other dimension is computed using the specified dimension, respecting content bias
  * of a root.
  *
  * <p>
+ * A default headlight will be added to a scene that contains {@code Shape3D}
+ * but without light source. This light source is a {@code Color.WHITE}
+ * {@code PointLight} placed at the camera position.
+ *
+ * <p>
  * Scene objects must be constructed and modified on the
  * JavaFX Application Thread.
  * </p>
  *
  * <p>Example:</p>