Ok hackers, listen up...<p>I know you love your fluid-width layouts, but just because you can fill the entire window with content, doesn't mean you have to. Blocks of text become difficult to read (and also ugly) when lines get to a certain length. The rule of thumb is that about 60-80 characters per line is comfortable. On my display, this site has about 250 characters per line and it makes me want to hit the back button. Yes, I can use Readability, but that strips out the code formatting. Simple fix: put a containing div around your content, and set a max-width on that container.<p>See Jashkenas's work for examples of well-formatted technical writing:<p><a href="http://jashkenas.github.com/coffee-script/" rel="nofollow">http://jashkenas.github.com/coffee-script/</a><p><a href="http://jashkenas.github.com/coffee-script/documentation/docs/grammar.html" rel="nofollow">http://jashkenas.github.com/coffee-script/documentation/docs...</a><p>Anyway, looks like a nice resource. Thanks for sharing.
Someone needs to make something like Eloquent Javascript [1] for CoffeeScript. The digital version of Eloquent JS has a console at the bottom so you can do the exercises without leaving the page. It sounds minor but when I was first learning javascript this solved a huge pain point.<p>[1] <a href="http://eloquentjavascript.net/chapter1.html" rel="nofollow">http://eloquentjavascript.net/chapter1.html</a>
I made this version. It would be great with 'Pull Request's with the kind of improvements that is being suggested here. The source is at <a href="https://github.com/autotelicum/Smooth-CoffeeScript/tree/gh-pages" rel="nofollow">https://github.com/autotelicum/Smooth-CoffeeScript/tree/gh-p...</a><p>I would also like to know if the 'Send to Kindle' readability function results in a readable document. That was the reason for making this version.<p>A pdf version, a quick reference and a JavaScript supplement is on the web site at <a href="http://autotelicum.github.com/Smooth-CoffeeScript/" rel="nofollow">http://autotelicum.github.com/Smooth-CoffeeScript/</a>
I'm a huge fan of CS (I'm spending about 10 hours a day in it right now for my startup) and I like the simplicity of the actual CS documentation.<p>This is really nice, but a bit too 'deep' or 'tl;dr' for my personal tastes. I was able to learn the basics really quickly and then started writing code and learning more from there as I ran into things I didn't know how to do.<p>That said, anything to further the learning of CS is great in my book. Nice job.