Use case

The HardwareKeyboard class mentions that:

RawKeyboard is the legacy API, and will be deprecated and removed in the future. It is recommended to always use HardwareKeyboard and KeyEvent APIs (such as FocusNode.onKeyEvent) to handle key events.

At the same time, the RawKeyboard class doesn't mention anything about HardwareKeyboard at all. As a result, it is easy to start using the RawKeyboard API by accident, if you came across that class first.

Proposal

Add a comment in the RawKeyboard class saying that developers should prefer the HardwareKeyboard class instead, similar to the note in the HardwareKeyboard class.