When I first started using Vim as my full time editor, one thing that tripped me up was copying and pasting to and from Vim where I run it in the terminal. Line numbers wanted to come with my copys, and indentation on code went wacky with my pastes into Vim. A couple quick, temporary settings changes, though, and Vim handles everything just fine.
When pasting to Vim in the terminal, if line indentation gets out of hand, progressively indenting each line. Fix it by turning paste on:
The following is a posting of my code from this month's Boise Drupal User Group presentation I did on Drupal's Batch API as it exists in Drupal 6. It also showcases a simple technique one could use for firing off batch operations via Drupal's admin interface. It's light on prose, and heavy on code.
If programmers wanted to be technical writers, they probably would be technical writers and not programmers. You can see that tautology played out in many a Drupal module where the documentation (most likely a README.txt) is on the light side, and the code is on the heavy side. Don't get me wrong, there's some great documentation out there, and many valiant efforts on the part of developers, but you just can't always depend on extensive documentation - especially when you're looking at a module that's not particularly mature.