This concern was originally raised by @barbu110 via facebook/react/issues/9684
Refer to the discussion on that thread for more backstory.
The outcome of that discussion is: Create a new guide called "Static Type Checking" that shows how to use React from Flow and TypeScript and describes main API definitions.