Tuesday, March 30, 2010

Judging a product by its documentation

A possibly disjointed post tonight, because Her Royal Kittehness is coming off anesthesia and I need to keep an eye on her. The documentation from the vet said that she might show less activity and appetite during the next few days. They lie. I've had to chase her away from the trash (which might, you understand, contain tasty butter-stick wrappers to lick) twice so far. Affection from her "hoomin" is a poor substitute. The ten o'clock feeding/medication will be a long time coming...

So I'm hoping for better luck with the documentation for haXe, which was brought to my attention by a pod-mate this morning. For the non-programmers, the premise of learning yet another language (haXe) gives more proverbial bang for the buck by allowing you to compile your source code into multiple languages: Flash/Flex, JavaScript, C++, etc. The documentation's just a small notch below "polished," which nevertheless puts it well into the upper percentiles of quality relative to that of its peers.

What really raised my eyebrows, however, was this little nugget from the project's home page:
1. Discover - Discover what haXe is about, how it works and how it could be useful to you.
"...how it could be useful to you": What a refreshing attitude when programming language comparisons so quickly seem to degenerate into spitting matches. No, I take that back. Spitting would be too adult. Make that "booger-flicking contests." Granted, I'm less than qualified to give an opinion on the completeness of haXe's features, the quality of its performance, or the reliability of its compiler(s). But I do know that it's a relief to be treated as a discriminating programmer, rather than another Kool-Aid-swilling acolyte. And I thought that deserved a shout-out.