Undecipherable product descriptions

By Confusion on Friday 12 June 2009 17:57 - Comments (4)
Categories: Java, Software engineering, Views: 2.725

Today I had to merge a Flex frontend into a Java project. Inside the Flex project, in a 'lib' directory, I found something called 'cairngorm.swc'. Having no experience with development in Flex, I had no clue what this file was. The person responsible was not available at the moment, so I did the only natural thing: Google it. That turned up Adobe's homepage for Cairngorm. The first section, which your eye falls onto when you view the page, is titled 'Overview' and reads:
Cairngorm is the lightweight micro-architecture for Rich Internet Applications built in Flex or AIR. A collaboration of recognized design patterns, Cairngorm exemplifies and encourages best-practices for RIA development advocated by Adobe Consulting, encourages best-practice leverage of the underlying Flex framework, while making it easier for medium to large teams of software engineers deliver medium to large scale, mission-critical Rich Internet Applications.
[..]
Ehmmm, yeah, right. Thanks for making me feel stupid. Now I still don't know whether it's a library that I need to include to get the application to run, a standalone Flex viewer/debugger or a collection of examples. By clicking "More information" and reading further, I didn't actually get more information. Only after a PgDn I finally encountered
The Cairngorm microarchitecture is intended as a framework for Enterprise RIA developers.
ah, framework. That's a word I know. So it's a library.

I have this kind of experience more often than I like to: I read an introduction to something and afterwards I still have no idea what the thing is. Is it just me or do you also feel introductions should start with the simple facts and purpose and maybe expand towards an all-encompassing vision of the developers towards the end, rather than starting out that way and leaving you at a plane of abstraction that causes you to miss the actual simplicity of the thing?

Volgende: A simple Java puzzler 06-'09 A simple Java puzzler
Volgende: Nasty Java HashMap race condition 06-'09 Nasty Java HashMap race condition

Comments


By Tweakers user H!GHGuY, Friday 12 June 2009 18:29

That phenomenon has a name:

MARKETING

Turn useful stuff into utter bullshit. Must be a great job!

By Tweakers user bulle bas, Friday 12 June 2009 19:31

Inderdaad grote peop.

By Tweakers user Roytoch, Friday 12 June 2009 20:50

@highguy: een fatsoenlijke marketeer denkt wel 3 keer na voor hij dit opschrijft. Om een knuppel in het hoenderhok te gooien: typische onontcijferbare programmertaal.

By Tweakers user Apache, Friday 12 June 2009 21:41

I did a flex project with cairngorm once, trust me, their description is not the only thing that's wrong with it ;)

It explodes the number of classes for each action you undertake on the client, it might be "structured", but it's just a architecture to bloatware, there are much better solutions.

Comments are closed