Highlights of Free Software Documentation #1

When someone undertakes something for fun, or out of passion or deep commitment, the end result is often, I think, more reflective of them personally.

This is generally true of Free Software, and in the Free Software universe, I think this is sometimes even more true of documentation–you’re not obligated to write it, no one’s paying you, few people enjoy writing docs, so if you’re doing it at all, it’s because you _believe_.

So the writers’ personalities and convictions show through just a little bit more, Like this bit from “Dave Rolsky”:http://autarch.org/ with whom I am slightly acquainted. Contained within “Moose::Cookbook::Basics::Recipe10”:http://search.cpan.org/~drolsky/Moose/lib/Moose/Cookbook/Basics/Recipe9.pod I ran across this gem:

bq. Our Human class uses operator overloading to allow us to “add” two humans together and produce a child. Our implementation does require that the two objects be of opposite genders. Remember, we’re talking about biological reproduction, not marriage.

Brilliant.