Hacker News new | ask | show | jobs
by cgarvey 5246 days ago
I'm really not a fan of the "Design" of this. It looks pretty, but the "wall of text" approach feels overwhelming.

It feels like it's half guide and half reference, but not particularly excellent at either.

Also the organization of content seems way off to me. In the first lesson I learn about things like code validation and CSS resets, but I don't even learn about html list elements until lesson 9?

I think with a lot of reorganization and better 'chunking' this would be a lot better.

1 comments

Other complaints aside, I just wanted to say that I quite like the "wall of text" approach. Thinking back to the article on API documentation from Parse (http://blog.parse.com/2012/01/11/designing-great-api-docs/) I'll agree that having everything on one page, quickly accessible, is a good way to do. By breaking up the page with relevant headings and sub-headings the docs can be made much less daunting (as they are here). I'd be much more annoyed with having to click between pages too often.