Classes and mixins section of Design chapter of Effective Dart should be rewritten accounting class modifiers feature of Dart 3.0 #6437
Labels
a.effective-dart
Relates to the best practices explained in Effective Dart
d.enhancement
Improves docs with specific ask
e1-hours
Can complete in < 8 hours of normal, not dedicated, work
from.page-issue
Reported in a reader-filed concern
p2-medium
Necessary but not urgent concern. Resolve when possible.
Page URL
https://dart.dev/effective-dart/design#classes-and-mixins
Page source
https://github.com/dart-lang/site-www/tree/main/src/content/effective-dart/design.md
Describe the problem
Guidelines
Don't take into account class modifiers: https://dart.dev/language/modifier-reference
This also affects other guidelines
Since Dart 3.0 limiting user's ability to extend/implement a class with class modifiers is a language feature, no need to be explicit in docs.
Expected fix
Change guidelines for API maintainers so that if a class not meant to be extended/implemented, they should use according class modifiers.
Remove guidelines for users since those are obsolete if API makes use of class modifiers.
Additional context
No response
I would like to fix this problem.
The text was updated successfully, but these errors were encountered: