Currently, the DartDoc for the verifyBeforeUpdateEmail contains some basic documentation on the function. Its counterpart, the regular updateEmail function however, has a much more extensive documentation, particularly including information about possible thrown errors and the need for potential reauthentication.

The documentation should be somewhat duplicated to the verifyBeforeUpdateEmail function, or there should at least be some sort of note to look at the updateEmail function for more info. There could also be other similar situations in which this occurs across the package or flutterfire.