Live data from Hacker News

Smooth CoffeeScript

autotelicum.github.com

1–10 of 27 posts

Re: Smooth CoffeeScript

#2
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.

[1] http://eloquentjavascript.net/chapter1.html

Re: Smooth CoffeeScript

#3
Ok hackers, listen up...

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.

See Jashkenas's work for examples of well-formatted technical writing:

http://jashkenas.github.com/coffee-script/

http://jashkenas.github.com/coffee-script/documentation/docs...

Anyway, looks like a nice resource. Thanks for sharing.

Re: Smooth CoffeeScript

#4
post #3

Ok hackers, listen up... 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 but…

Just shrink your window if you want 80 chars per line, jeez.

Re: Smooth CoffeeScript

#5
post #3

Ok hackers, listen up... 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 but…

Just shrink your window if you want 80 chars per line, jeez.

sigh

Re: Smooth CoffeeScript

#6
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 https://github.com/autotelicum/Smooth-CoffeeScript/tree/gh-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.

A pdf version, a quick reference and a JavaScript supplement is on the web site at http://autotelicum.github.com/Smooth-CoffeeScript/

Re: Smooth CoffeeScript

#7
post #3

Ok hackers, listen up... 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 but…

Just shrink your window if you want 80 chars per line, jeez.

I'm not sure if you're being sarcastic, but the parent was offering advice for accessibility to help the member's of the community improve on their projects. Why would you disapprove of that?

Re: Smooth CoffeeScript

#8
post #3

Ok hackers, listen up... 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 but…

Legibility is vastly improved in the readability-powered version (upper-left button).

Your point still stands, of course.

Re: Smooth CoffeeScript

#9
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.

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.

That said, anything to further the learning of CS is great in my book. Nice job.

Re: Smooth CoffeeScript

#10

Earlier quoted context omitted.

Just shrink your window if you want 80 chars per line, jeez.

I'm not sure if you're being sarcastic, but the parent was offering advice for accessibility to help the member's of the community improve on their projects. Why would you disapprove of that?

I personally hate when sites make the text narrow. If I want the text narrow, I shrink the browser. (Which I never actually do BTW.)

So to me the advice makes things worse, not better. 60-80 chars per line???? Even my email is wider than that. Go for at least 200.

Post reply on HN