Musings: Flex 3 vs. Flex 2 Help

This post was written by jimrobson on April 29, 2008
Posted Under: Flex

In the grand scheme of things, this may not seem like a big question. However, as a developer who likes to reference the API documentation frequently, it seems significant. The question is this: Why does the Flex 3 Help feature bury the API documentation when the Flex 2 Help feature made it so readily available?

Here is what I mean. In Flex Builder 2, if I typed “Canvas” in the search field, the first entry in the list was mx.containers.Canvas - Perfect! Exactly what I wanted!

Screen shot thumbnail: click to view full-size image

However, if I type “Canvas” in the Flex Builder 3 Help search field, mx.containers.Canvas is way down in the list. It’s number 25 to be precise.

Screen shot thumbnail: click to view full-size image

What is even more puzzling is that if I type in “mx.containers.Canvas” the first item that comes up in the list is mx.containers.utiltyClasses.IConstraintLayout. Why does this happen? What cosmic forces are at play here? You may ask, “Where is mx.containers.Canvas in this scenario?” Well, I will tell you: It is number 10 on the list.

Screen shot thumbnail: click to view full-size image

While this question may not be up there with “What is the meaning of life?” it is nonetheless a nagging question in my little mind. Perhaps the answer lay somewhere out there in the vastness of the blogosphere, but as yet I am still in search of it. But the pursuit of truth is a grand adventure, and I will not tire of it! :-)

Tags:

Reader Comments

I’m glad I’m not the only one who finds this infuriating.

I find the new “user-friendly” help to be anything but. Show me the API man!

#1 
Written By Marty Pitt on April 30th, 2008 @ 6:13 am

I have for years found the Flash MX/2004 (and Flex 3) help sub-par.

I am always of the opinion that when searching help docs, the very first record turned up should be that specific object’s reference page.

Not bazillions of other object’s who feature that item in an example or what not.

*sigh*

I used Flex 2 for only a few weeks. I did not know it actually worked. (I’ve always considered “Search” in help to be broken in Flash products.)

:|

#2 
Written By Jason The Saj on April 30th, 2008 @ 11:42 am

I also want to chime in on the following site:

http://livedocs.adobe.com/flex/3/langref/index.html

Great potential site, but why when you search are taken away from the site? You get links all over the web. Annoying!!!

#3 
Written By Jason The Saj on April 30th, 2008 @ 11:46 am

Add a Comment

required, use real name
required, will not be published
optional, your blog address