promote the use of interpolation in the documentation

[michaelficarra]

This one's mostly for @jashkenas. We should be promoting the use of interpolation by including it throughout the documentation.

[jashkenas]

I was trying to introduce one concept at a time, and avoid relying on things introduced further down the page, if possible. ... to make it easier to read through. What do you think?

[michaelficarra]

That's kind of a question of whether it's a fundamental part of the language (like function literals, string concatenation, array literals, regular expressions, etc.) or a more gratuitous or uncommon feature like the various pieces of syntactic sugar we have. I think it belongs in the first group, as the "de facto" way of building strings, hence the pull request. If you're still worried about it being unfamiliar or something, maybe move the interpolations up toward the top? Sting building is a fundamental feature of a programming language like this one, just like function application.

[itay]

I agree with Michael - I also think it's definitely one of the strong features of CoffeeScript, and I always dread regular Javascript due to it.

I'd like to see the explanation moved to the top - maybe even with some more examples to show the power and expressiveness.

[michaelficarra]

Also, it would be very helpful to mention @satyr's recommended solution to #1406 so people can easily construct strings without null/undefined values.

[TrevorBurnham]

I think this is a sensible change. Many of the most common questions/complaints we get are along the lines of "Why do a + "b" and a +"b" mean different things?" And the most satisfactory answer is always "Well, just use string interpolations so it's not an issue." The syntax is pretty self-documenting anyway when the JS output is next to it.

[michaelficarra]

I think we came to a fair enough consensus here. @jashkenas: ready to merge?

[jashkenas]

Sounds good.