search

elm / elm-lang.org

Server and client code for the Elm website.
http://elm-lang.org/
BSD 3-Clause "New" or "Revised" License
1.99k stars 367 forks source link

"Intro to Lists and Records" is missing explanation #178

Closed danluu closed 9 years ago

danluu commented 10 years ago

http://elm-lang.org/learn/courses/beginner/Lists-and-Records.elm says

The video is followed by a written explanation that covers exactly the same material.

but there's no written explanation!

evancz commented 10 years ago

Thanks :)

I finally started working on improving the learning resources for union types, signals, and architecting Elm programs. Part of that covers lists and records, so there will probably be some sort of duplication.

One solution may be to just say "The video is followed by some example problems." So we can sidestep the issue. How does that sound for now?

danluu commented 10 years ago

Sure! That's not ideal, but there's probably lots of other stuff that's higher priority, right?

I've been messing around with elm lately so I may watch the video and try to write up an explanation at some point, if I keep screwing around with elm.

The reason I ran into this was that I was trying to turn a record into a list of records, and it took some searching to find docs on how to manipulate / recurse through / iterate through a list. The examples that I could find in the giant example thing only showed how to construct a list. Is that an intentional decision? I can see why you might do that on purpose, but it also makes it somewhat difficult for total beginners who are trying to figure out how to use lists.

If you're open to modifying the example section and adding a few examples, I think that would go a long way.

evancz commented 10 years ago

There's just lots of stuff :) One of the priorities is updating the examples and learning resources for modern Elm. Almost all of the examples were written 1 or 2 years ago, so they emphasize things that it probable does not make sense to emphasize anymore. So I want to go through the examples and reformulate them to be more helpful for the kind of folks learning Elm today. Overall I'd say no omissions like you describe are intentional. The true solution may be someone taking up the "teach Elm" task independent of the website so things can move quicker, but it's at least on my list to fix the stuff you describe!

In any case, if you do get a summary of the list/record video, that'd be great :)