Post Archive
› August 19, 2002
Documentation on the documentation
In trying to install Active State's "ActivePerl" for a client with a windows server, I ran into a very frustrating problem with getting things configured to work. The install went through without a hitch, and perl was obviously running, but no dice through the web server. After a good nights sleep, I found the appropriate documentation for my problem here. Starting at the ActivePerl homepage, it takes about 7 clicks to get there, assuming you know where you're going. The documentation is split up into various non-documentation choices plus the actual documentation, from here you can navigate to what seems like the appropriate area, only to find that there is a FAQ which might have your answer. Three levels into the FAQ, the usefull stuff appears. Don't get me wrong, I'm very happy with the ActivePerl product, and the actual install/config was a piece of cake (once I know how), it's finding my way through the documentation which made me pull out my hair. I get the distinct impression that the folks at Active State were simply trying too hard, I also think that even one usability test of their documentation with one person would have raised a big red flag.