fabulous-dev / Fabulous

Declarative UI framework for cross-platform mobile & desktop apps, using MVU and F# functional programming
https://fabulous.dev
Apache License 2.0
1.13k stars 122 forks source link

Improve code documentation for MVU/Elm newbies #1067

Open h0lg opened 4 months ago

h0lg commented 4 months ago

I'm currently wrapping my head around Elm, MVU and Fabulous, had a look at the changes in pre-release 2.5 #1065 6de97c06b0f2cc99a6349da8ec3177876953fe4a and tried to update the code documentation in a helpful way by connecting types to Elm or MVU concepts. This is an attempt to make Fabulous a bit more approachable for newbies like me who may or may not have done their homework learning about MVU and Elm.

Please review my changes carefully to make sure I'm not confusing things and correct me if I did! You'll find some questions concerning opaque concepts like CmdMsg vs. Cmd<'msg> as well, which I mentioned in #927 .