News for hackers. Stuff that matters.
Re:Kiln by mion on Sunday March 31, 2013 @09:58PM (#5471044)
This is awesome, great work! However, and I don't mean to be rude, lemme just give you a tip about your documentation.

I'm not a "documentation expert" or anything, but IMHO I'd say there is too much information on your "landing page" and not a clear "call to action":

- How about some installation instructions?

- Basic usage? (addressing the main features, those which most users will probably use most of the time) If I were you I'd put the details about plugins somewhere in the Wiki.

I don't have a lot of spare time to check out your thing, so the project becomes increasingly unattractive as I have to waste more and more time to figure out how to use it / how to get it up and running for a basic test.

Again, IMHO, I believe this applies to most hackers, and to open source documentation in general. Very often I see great hackers who can code 1000x better than I do, but fail to write 'attractive' documentation for their projects.

There are no comments on this comment yet.