search

Zaid-Ajaj / the-elmish-book

A practical guide to building modern and reliable web applications in F# from first principles
https://zaid-ajaj.github.io/the-elmish-book
Other
338 stars 50 forks source link

Placement of advanced content #20

Closed theimowski closed 5 years ago

theimowski commented 5 years ago

It's really great to have the advanced (compat, fable packages, bindings, etc.) sections in the book, however I'm wondering if it'd be better to place them a bit further in the book - a beginner reader would likely follow chapter by chapter, and those advanced topics might be overwhelming. I've seen the note about advanced sections in ToC, but still thinking out loud if it'd be better to have them later in the course

Zaid-Ajaj commented 5 years ago

Actually I was thinking of removing the note that this is "advanced content" from the ToC to just "content" like the rest of the sections because these sections are really important to understand what a developer can or cannot do with Fable and why certain features will work and others won't regardless of whether you will build Elmish applications or web applications etc.

still thinking out loud if it'd be better to have them later in the course

I was thinking of that before but they are just a couple of sections, too few to make for an entire chapter and the content is still very much relevant in chapter 2 and 3 so I would rather keep it in chapter 1

theimowski commented 5 years ago

Ok makes sense, however keep in mind these sections could frighten some newcomers that are eager to just have something up and running first without going into much theory. Anyway that's probably just a matter of preference

Zaid-Ajaj commented 5 years ago

Should I add this in the beginning of the book? 😜 3aywq2