Confusing Things

[evancz]

This is a meta issue to organize all the confusing things in one place.

I batch work on my projects, so I will be revisiting my book in one big batch to extend and revise the content. That way I can address the confusion in a coherent way, perhaps changing structure or framing significantly.

Until then, here is an overview of the things folks have found confusing:

Transitions:

• Function call syntax is different than C-style languages - #22
• Introduction of beginnerProgram is rough - #87
• Transition from beginnerProgram to program is rough - #28, #54

Expand Content:

• Show a type alias that uses type variables - #74
• "idiomatic" answers to exercises / form validation - #15
• Present type annotations better - #45, #46
• Ports examples should be better - #34, #17