Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Feedback #1

Open
xaoo opened this issue Feb 10, 2023 · 2 comments
Open

Feedback #1

xaoo opened this issue Feb 10, 2023 · 2 comments

Comments

@xaoo
Copy link

xaoo commented Feb 10, 2023

Amazing documentation about Design Patterns, very comprehensive, easy to understand.

Here, you mention: "yes, I do consider your feedback, so do not hesitate to share your insights about the series - it helps me improve the quality of the content a lot!".

I did not found a direct link to send feedback, so I just assumed it was here :).

  1. It would be nice to see all Design Patterns directly in their appropriate category: "Creational", "Structural", "Behavioral" (as in the mobile animation), of course already expanded for a better UX. I think I would consume the content better, and understand where each Design Pattern suits better.
  2. I found lots of examples for Class Diagrams explanations, unfortunately they were all inconsistent, even different or missing important explanation or elements. It would make a lot of sense if you also provide a new blog post (or a series of them), with all the explanations, ex.: what each arrow means, why that particular arrow was used, how to use them to better represent an architectural class diagram.
  3. This is related to the 2nd point, maybe an in-depth blog post with exercises, where we can try to implement the requirement ourselves, pick the correct pattern(s) design the correct class diagram. But maybe not with so obvious exercises like car classes, animal classes or people classes, something more abstract where its no so obvious/easy to implement/create the architecture, then the implementation (I hope this is intelligible). We can choose to see also a provided solution(s) to compare and learn.
@mkobuolys
Copy link
Owner

Hey! Thank you for the feedback.

  1. Could you elaborate on this point a little bit more? Web and mobile views for the app are identical, just the responsive principles are applied. Meaning, all the patterns are provided in their corresponding categories, just maybe the list is collapsed, true. Do you think just expanding the section by default would help?
  2. I do not think that class diagrams are inconsistent, just maybe that's related to the point you mentioned:

<...> they were all inconsistent, even different or missing important explanation or elements. It would make a lot of sense if you also provide a new blog post (or a series of them), with all the explanations, ex.: what each arrow means, why that particular arrow was used...

Indeed, different arrows mean different things (e.g. implements vs extends), thus you could see they are different across the class diagrams. However, I think I should go through all of them and double-check, and update them if needed.

  1. I see your point, just teaching/educating about the UML notation was not my goal. However, writing an introductory article explaining the notation may help the readers - I will think about it. What's related to challenges - I hear you, just I am not sure how this should work. Maybe it would make sense to write another article series about Flutter Design Patterns in real life, and how certain problems required the corresponding OOP solutions. I talked about it a bit in my Design Patterns talk, maybe it would require continuous effort and writing an article once a certain real-world example occurs.

@xaoo
Copy link
Author

xaoo commented Feb 14, 2023

  1. Sure, right now, all Design Patterns are within the same parent (same level/indentation). Maybe, if possible in Docusaurus, each DP can have "Creational" or "Structural" or "Behavioral" as parents (some form of category separation). As UX, I can collapse each category and at any time, for example:

Design Patters

Creational

DP1
DP2

Structural

DP3
DP4

Behavioral

DP5
DP6

  1. Sorry for the misunderstanding, I meant the inconsistency in Class Diagrams are between different articles on the internet, not your blog. The point here is, if possible, to have a pre-requisite document, where I can study all Class Diagrams particularities/notations, maybe with some small examples, then when I come back to a DP, I would be able to understand the 'WHYs'. Here I just assume if you are going to do this blog, it would be very consistent with all examples in DPs.
  2. Flutter Design Patterns in real life this would make a lot of sense, with some homework for the readers, DIY then come and compare the possible solutions.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants