You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The current example code on pub.dev is bloaded and includes too much irrelevant details/widgets that does distract from understanding and implementing the core functionality of the package.
This complexity extends the time required to understand and implement the package: for example, usually, it takes me about 15 seconds to at most 1 minute to understand how to implement a package based on the example provided assuming said package is not something very complex such as state management packages, this one took me much more, because I couldn't even see, where in the overly long code the actual tab bar was implemented, and not knowing which line was relevant, I had to read through them one by one.
Suggestion: Provide a shorter, minimal reproducible example focusing only on the package's core implementation. If additional code is necessary, consider adding artificial large spacing and and multiple line of denotation comments to better highlight the essential parts or do extract and abstract away the implementation of all that wrapping around the main package and put them below so that the actual package implementation is seen within the first few lines.
The text was updated successfully, but these errors were encountered:
Thanks for pointing this out and sharing your suggestions, I'll look into that and add a shorter example for the users who need the package's core implementation and for the advanced examples then they can use the current one with all the denotation comments :)
The current example code on pub.dev is bloaded and includes too much irrelevant details/widgets that does distract from understanding and implementing the core functionality of the package.
This complexity extends the time required to understand and implement the package: for example, usually, it takes me about 15 seconds to at most 1 minute to understand how to implement a package based on the example provided assuming said package is not something very complex such as state management packages, this one took me much more, because I couldn't even see, where in the overly long code the actual tab bar was implemented, and not knowing which line was relevant, I had to read through them one by one.
Suggestion: Provide a shorter, minimal reproducible example focusing only on the package's core implementation. If additional code is necessary, consider adding artificial large spacing and and multiple line of denotation comments to better highlight the essential parts or do extract and abstract away the implementation of all that wrapping around the main package and put them below so that the actual package implementation is seen within the first few lines.
The text was updated successfully, but these errors were encountered: