5 ms·
To whoever manages this page: please rethink the way you're introducing the library. I read the first three paragraphs and still had no idea what was going on.
by ianstormtaylor 13y ago
To whoever manages this page: please rethink the way you're introducing the library. I read the first three paragraphs and still had no idea what was going on. All I learned was that Stylus was involved. Then the next section talks about when and where to use mixins, and the logic for when to use the "native form" vs. the "mixin form" seemed weirdly rigid, so I left.
If you want people to use your library, they need to understand it. And if you want them to understand it, you need to be more compelling. Only after going back to make sure I'm critiquing you right did I realize this was part of a bigger toolkit at all.
Oh, and please increase the font size.
- khet 13y agoI had better luck and found this video which explained it pretty well. http://www.youtube.com/watch?v=47Qv6djtKlY&feature=youtu.be http://www.youtube.com/watch?v=47Qv6djtKlY&feature=youtu... But I agree with you, the author should probably try an intro video on the homepage.
- jenius 13y agoyou found that video on the real homepage ; ) the page that had been posted here was the css library documentation
- jenius 13y agoHey wow didn't realize this had been posted on hacker news - I'm the author of roots and here way too late to field comments. Thanks so much for the feedback Ian! No need to assume such a critical tone, I'm open to any and all feedback, so let's keep it friendly. Let me try to explain why I have that intro paragraph there. Stylus is a very open and flexible language, and the same statement can be written many different ways. In addition, it's not as commonly used as something like sass, so there aren't well-known conventions that have arisen. All I was doing here was trying to establish and explain a couple conventions, to make life easier and more clear for everyone. In addition, someone randomly posted the documentation page for the css library here rather than the homepage. This might be part of the reason why you were confused about what exactly this is. Would love to hear more about how I could be 'more compelling' with this - always a great goal and something I hope I am able to do -- of course keeping in mind that this is a documentation page.
- mankyd 13y agoI'd agree with the OP here. Stylus may be "very open and flexible" but I don't know what stylus is either. I came to your page because I wanted to find out about roots, not about stylus. Open with a statement saying "Roots is a css framework that does X". Maybe have a follow up statement saying "Roots is based on the stylus language".