Showing posts with label .NET. Show all posts
Showing posts with label .NET. Show all posts

Friday, May 30, 2008

Web Service Documentation Outdated by Provider

I really don't want to mention names as it might incriminate me, but a provider of a web services I'm currently trying to develop to has really outdated and non-functional samples as well as documentation. First, I'm semi-impressed that the organization actually has any samples or docs but am quite disappointed at the lack of relevance and support they provide.

I've beat my head against this problem for too long and it's been a painful experience. Despite the inconvenience, I must admit that my tenacity has delivered little in terms of tangible achievements but intellectually has caused me to dive deeper into the .NET platform than I'd originally believed I'd need.

That being said, life in Texas for me personally has been a little out of sorts. My nights have been later which translates to less sleep. My exercise has suffered which amounts to a stiffer knee. Has my family life suffered? Well, my wife typically goes to bed alone which doesn't help our relationship much. To top it off, I'm a bit crankier because my efforts have yielded very little throughput success.

Whether the payout on the project offsets the discomfort of the process is the question that remains in my mind. Were this another project that was going smoothly, little pressure, and heads down development, I'd say the payoff would be a walk down "Easy Street" but this case is the negative end of development for which the payout is questionably lacking.

What would I change in this process? One must ask themselves this question in order to allay future scenarios of repetition. The things I can control I have. But in the event the tables were reversed and I were the provider, I would need to make a conscientious effort to keep the documentation up to date and the samples relevant to the targeted audience. To merely discount a consumer's work by stating that "it works on our end," is unprofessional and unacceptable. Note to self: provide impeccable support and go the extra mile to assure customer success.

What makes me feel just a little better through all of this is a CTO's experience has run into the same roadblocks that I have and the frustration is shared by more than just myself. Would that this bit of comfort be enough to actually complete the task at hand. Alas, a miracle and possibly greater wisdom (or documentation and relevant samples) is the order of the day!