KBD

Keith Devens .com

 Sunday, March 21, 2010 Flag waving
And if you go too far up, abstraction-wise, you run out of oxygen. Sometimes smart thinkers just don't... – Joel Spolsky
Home » Archive » 2003 » August » 03 » Show me the code!
← The Doomsday AlgorithmCreative Commons →

Daily link icon Sunday, August 3, 2003

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.

Chain link icon Permalink | 1 Comment | id 4148
09:13 (utc-4)
edited: 09:22 (utc-4)
 
← The Doomsday AlgorithmCreative Commons →

Comments XML gif

M. Bean wrote:

30 seconds? You are a much more generous person than I. Smiley winking

∴ M. Bean | 3-Aug-2003 2:48pm est | #2632

Feel free to post a comment below. Please see my comment policy.

Formatting Rules (No HTML):

  • **bold**, *italic*, _underlined_, --strikeout--
  • "text"="url" creates a link, and URLs are auto-highlighted
  • Blockquote: Like e-mail, begin paragraph with > (greater-than sign)
  • Lists: begin paragraph with *,-, or + (unordered), or # (ordered)
  • Code block: ?!code:language=perl|php|sql|javascript|etc.{\n}...{\n}?!/code
:
(will be your IP address if blank)
 : (optional)
(Will not be shown on site)
: (optional)
:

March 2010
SunMonTueWedThuFriSat
 123456
78910111213
14151617181920
21222324252627
28293031 



RSS feed RSS feed for Keith's Weblog
Atom feed Atom feed for Keith's Weblog
Weblog archive
Recent comments
  on 3 posts

Recent comments XML

new⇒Spider solitaire

I to am somewhat addicted to​spending too much time on SS.  I​have been stu...

stupid_horse: Mar 20, 10:34pm

I hate ASP.NET

I hate ASP... I was doing wonders​with PHP, then suddenly one of my​clients...

Johnies: Mar 17, 6:14am

Quantum physics and free will

I knew you were going to say that....

Tom Massey: Mar 15, 9:26pm

Generated in about 0.106s.

(Used 8 db queries)