Artifacts as experience

jplindstrom on 2003-04-21T18:49:04

Experience with a language or tool or environment is not just the things you learn. Not just the practical, hands on tricks you have developed over the years and use every day to get the actual work done.

Experience, and what makes you productive, is also things you already did, things you can reuse, artifacts of the coding process. The ability to copy-paste a few lines of syntax here and there; less than is useful to put into a routine, more than what is practical to type each time.

So having done things in the past makes you more comfortable doing it again, not only because you know how it works, but because you have the code to remind you how it works.

In CPAN modules, The SYNOPSIS section of the documentation is this artifact. Some learning styles rely heavily on examples, which makes it kind of important to put some energy into the synopsis.