Topic: Managed API Rant

[Kerry]

<deleted by author>

Summary of deleted content (with expletived and derogatory remarks elided)

Where is the Managed API documentation ?

The current Help Documents are little more than a signature list.
I get more help and insight from my peers than I do from any product documentation I've seen.

We've been waiting long enough.

As a lisp programmer wanting ActiveX documentation I've been told for more than 15 years to read the VisualBasic documentatio and make my own translations.

As a DotNet developer I've been told for 6 years to read the ARX documentation and make my own translations. (or guesses)

I've had a gut full of being treated with disrespect.

calm Regards
kdub

[MP]

Must be something wrong with me, I've never felt like I was "being treated with disrespect" because I had to sleuth out info, tho I could certainly see how it could be mondo frustrating for some.

[Kerry]

Hi Michael,
I relish sleuthing as much as you do.
Some people are not as good at it as you and I.

I'm imagining how much more productive we (as a group) could be if we didn't have to do quite so much of it.

I've had several communications from people suggesting that they would have been unable to solve issues without the posts at TheSwamp and peer to peer support received here and at the Discussion Group ...

it's not the act of sleuthing that's frustrating, it's the ongoing necessity.

Part of my personal difficulty is that I haven't done a lot of keybashing in the last 12 months and I'm subject to the 'use it or lose it' syndrome .... this means re-researching stuff ... not productive.

Be well

[Keith™]

Kerry, I happen to agree with you 100% .. if there were better documentation, it would be infinitely easier to develop solutions with the tools available.

I regularly pound out code that makes use of poorly documented API calls, managed or not ... what is even more infuriating is when you develop a solution predicated on one of these undocumented API calls and it is later changed and causes the code to fail intermittently.

In one application I spent two years developing, the managed API didn't ... in the end, much of the functionality had to be removed because of the errors generated from "managed" code. Supposedly, MS is working on a fix to the memory error not being propogated, but I don't hold out much hope.

[MP]

Can't refute a single thing is subsequent posts.

[SEANT]

I suppose it makes sense economically; sleuthing is the price we pay for not enrolling in ADN.  That statement does presume significant additional resources to enrollees.  Are there any ADN members here willing to give an opinion?

Conceivably, we derive some benefit from our programming skill, regardless of our position as a professional programmer.  The benefit is likely enhanced due to the price of admission.

I think it safe to say that most of the Swamp.org members enjoy a benefit that is not strictly financial.  As a matter of fact, this site would probably be considerably less lively if the task of learning the APIs were considerably less difficult.

[Kerry]

< .. >  Are there any ADN members here willing to give an opinion?[/i]

Yes. And I have.

[Kerry]

< .. >
 As a matter of fact, this site would probably be considerably less lively if the task of learning the APIs were considerably less difficult.

I can't really agree with this. I think we would stay lively and have moved on to more challenging topics.

[SEANT]

Yes. And I have.

A quick search hasn’t returned anything definitive – though it was quick:  What is your opinion of ADN?

I can't really agree with this. I think we would stay lively and have moved on to more challenging topics.

Perhaps.  The Swamp was a welcome find for me due to the aforementioned reasons.  That common goal has focused a competent and eclectic group of people.

[Kerry]

< .. >  What is your opinion of ADN?

If the ADN was an independent service I doubt it would survive.
Having access to various versions and builds is a big help sometimes.
The ADN is not some magical storehouse of chants and spells. The knowledge base is really just a refined collection of some of the questions asked and answered .. handy sometimes, but I don't think the interesting questions and answers ever see the light of day.
The answers to any questions I've asked are sometimes helpfull .. though the wait is sometimes painfull.

This actually expands on the point I was trying to make initially.  If we had complete API documentation the ADN could be used for solving the more difficult problems that arise, rather than servicing simple "How do I .. " questions.
Actually, I'm prepared to hazard a guess that the ADN tech guys have as much trouble as we do finding out specifics about the API.

We only have to analyse the questions that are repeatedly asked here at TheSwamp , at the DicussionGroup, at Augi, at CadTutor etc to realise how much waste is being caused by not having complete documentation .... this is compounded by the fact that sometimes the answers are guesses and wrong and sometimes it takes an inordinate amount of peer patience to actually determine what the actual question really is. Any dotNet AutoCAD internet search will currently return more out of date information or incorrect/halfcorrect guesses or pleas for help that it returns usefull relevant data.

There are several blogs that help to fill some of the gaps with insightful posts ... but my argument is that they only partially fill gaps in information that should be available in one, or a series of coordinated documents.


I probably should just revise my expectations, but I'm sure they are also the expectations of a lot of other people who aren't so forthcoming.

Regards and apologies if your ears hurt
kdub

[SEANT]

. . . . apologies if your ears hurt
kdub

Quite the contrary, it is posts like this one that make the swamp worth the price of admission – even if it had a price of admission.


I have had fairly limited contact with Autodesk personnel (through non-ADN channels) and can say that, in each instance, they were as helpful as they could be.  There was always this undertone, however, that the personnel were hampered in there ability to provide more assistance.  I suspect that Autodesk’s marketing and legal divisions are much more the problem with regard to an ADN tech’s ability to dole out information.

I should point out that I am somewhat of a ‘conspiracy theorist’ (actually more of an ‘emergent behaviorist’) but now that some of the ADN hierarchy are members, perhaps additional light can be shed on this matter.

[Kerry]

(actually more of an ‘emergent behaviorist’)

wow, following that thread would be a psychological diversion

[Jeff H]

One thing with ADN guys is  everyone I dealt seemed to be a smart guy, but they have direct access or just send a e-mail to the guys who are most knowledgeable with that portion of the API. Not sure how the teams are broken up but from responses it seems they basically know who or what group of guys deal or maybe even wrote that functionality of ObjectARX or AutoCAD.
 
The way I look at it is the API is so huge it would take a much more resources to keep up with documentation.
 
When looking at the .NET API they really do not add many layers to simplify it. Of course some differs and certain aspects are different but if you are trying to figure something out and looking at a  C   example is basically as good as looking at a .NET example.
 
I really do not think AutoDesk spends as many resources or places the API as a high priority as they claim.
 
On the other hand with how large and complex the API and the complexity under the hood with the resources given I wouldn't expect much more.
 
As for getting upset I do get frustrated sometimes but it does not take long to see what you will be dealing with and no one is forcing you to do it. I do not think it takes much to figure out that in the end your code has to make calls to Autocad code base so you are completely dependent and forced to deal with Autodesk's implementation.
 
In the end AutoCAD is a product and not a platform.

[It's Alive!]

I usually have a Cafe-Mocha-Vodka-Valium-Latte before reading the docs. give it a try

[Jeff H]

I usually have a Cafe-Mocha-Vodka-Valium-Latte before reading the docs. give it a try

Please no one read Daniel's post and take that serious as taking any of those will only hurt your ability to understand the information in docs.
If really want help you need a good amount of coke, crystal meth, and amphetamines.