Clarify how Enum Classes differ from dart 2.17 enhanced enums with members

[TzviPM]

See annaouncement post from Dart 2.17 which details changes for "Enhanced enums with members": https://medium.com/dartlang/dart-2-17-b216bfc80c5d#:~:text=Enhanced%20enums%20with%20members

The documentation for built_value still mentions:

For an object oriented design, though, enums need to be classes. Dart falls short here, so Enum Classes provide what's missing!

This remark seems outdated. That said, it does seem that EnumClasss are still relevant for serializability (see #1147 (comment)).

The documentation should be updated to clarify the feature overlap and why EnumClass is still relevant. Furthermore, if dart's implementation could make serializability possible without EnumClass, then an issue should be opened in dart-lang itself and one here to track any upstream changes and deprecate EnumClass.

Please let me know if I can help with taking ownership of these changes and pushing them forward.

[TzviPM]

cc @davidmorgan for context

[phamnhuvu-dev]

I also need it

[davidmorgan]

I'm currently looking at changes needed for Dart 3; that will likely happen before I get a chance to look at enhanced enums, unfortunately.

[TzviPM]

I was just thinking about that too. Specifically, sealed classes could probably be generated for union types.