JavaFX 25 API中的预览特性真的被标记为已弃用了吗？

• javafx.scene.layout.HeaderBar被标记为Deprecated是属实的，并非文档错误
  这个类在JavaFX 25中确实已被官方废弃，原因是JavaFX将HeaderBar的实现从javafx.scene.layout包迁移到了javafx.scene.control包下。如果你需要使用HeaderBar组件，应该改用javafx.scene.control.HeaderBar，这个新包下的类是当前推荐的实现版本。

• Java SE与JavaFX文档标记差异的说明
  Java SE文档（比如你提到的StableValue）中的预览特性标记，和JavaFX文档里的废弃标记属于完全不同的概念：

  • 预览特性是Java SE中尚未正式稳定的功能，标记目的是提示开发者该功能可能在后续版本中变更；
  • 而JavaFX里的Deprecated标记是明确告知开发者某个API已被淘汰，建议迁移到替代API。
    两者的设计目标和使用场景不同，因此文档中的标记方式自然存在区别。

内容的提问来源于stack exchange，提问作者Ladislav Török