Keith Devens .com

Show me the code!

Note to everybody who creates something: Show me a freaking example of it! A sample file of your markup language, some sample code that uses your library or API, anything more a stupid useless grammar or a function reference would be nice. Do it right on your home page, or have a link that says "What does it look like?" clearly visible. Don't frustrate me! Don't expect people to read your grammar and grok it. You might even make up some use-cases to explain to people how they can expect to be able to use your creation. If I can't go to your site and understand what the hell you're doing in 30 seconds or less, you've already frustrated me and I'm mad at you.

Permalink | 1 Comment | id 4148

09:13 (utc-4)
edited: 09:22 (utc-4)