Sunday, February 22, 2004

Writing Documentation Sucks

As a few people noticed we were asking for beta testers for our XPComponents last week.

Well first we were stunned by the response, thought it would take weeks to get the people we wanted, instead it took hours!

Of course then we were caught wrong footed, the docs were not ready to start the beta!!

So this week has been a week of writing docs. Boy does it suck. You seem to write forever and still there is a mountain to climb.

Now I understand why MX2004 got released befor the docs were ready lol!!

I have to mention here JellyVision's ActionDoc it is a superb tool for building documentation for AS2 classes even though its still in an early beta phase.

If you havent got it ... get it now!


Actually, confession time, the last few months of building our components has given me a lot of understanding for WHY MM did certain things the way they did. Sometimes we would find after doing something we swore we wouldn't do that MM had done something quite similar, its like developing incrementally you can end up at a point where there is no way out but to do what at the outset you thought was unecessary

Having said that, it hasn't changed my views on the MM Framework, concept excellent, implemantation flawed, sorry for that!

No comments:

Post a Comment