Technical documents should be reviewed by technical people

Just recently, I was implementing a protocol at work. The protocol was handed to me in the form of a Word document and it appeared to have already cleared some approval stages. The protocol seemed over-engineered to me. It used HTTP POST with XML in the request and response bodies. There was actually only one message type and it seemed like it could have easily been implemented with a simple GET request and no response body (just an HTTP response with a proper response code). The document was 24 pages long when it only required 1. It had about 10 error response message types, about half of which had to do with XML errors. I looked at who reviewed the document and it was as follows:

  • Author: Engineering Manager
  • Reviewer: VP Engineering
  • Reviewer: Technical Director
  • Reviewer: Director of Engineering, Client Engineering
  • Reviewer: Director of Engineering, Host and Infrastructure Engineering
  • Reviewer: Engineering Manager, Quality Engineering

Missing are Principal Engineers and most importantly, Senior Developers, like myself, who will be implementing the protocol. It's not even necessary to consult the people who will be implementing the protocol, but you need to consult with people who understand HTTP, have experience with using web protocol, and an understanding of programming. One of those listed above qualifies in that respect, but that is still just one person. I am sure that if this was shown to three other people who aren't managers, directors, or VPs, they would say this protocol is over-engineered. If even one person thinks it's over-engineered, and over-engineering things is costly. It adds complexity on both sides of the protocol which means more development, more bugs, more testing. There's no excuse for over-engineering things and not excuse not to have technical documents revealed by those who will implement, the hands-on technical people.


Thanks for posting this info. I just want to let you know that I just check out your site and I find it very interesting and informative. I can't wait to read lots of your posts.

You have done a great job on this article. It’s very readable and highly intelligent. You have even managed to make it understandable and easy to read. You have some real writing talent. Thank you.

This is a great inspiring article.I am pretty much pleased with your good work.You put really very helpful information. Keep it up. Keep blogging. Looking to reading your next post.
star wars shirts

I haven’t any word to appreciate this post.....Really i am impressed from this post....the person who create this post it was a great human..thanks for shared this with us.

I am continually amazed by the amount of information available on this subject. What you presented was well researched and well worded in order to get your stand on this across to all your readers.​tree removal omaha

Wonderful blog! I found it while surfing around on Yahoo News. Do you have any suggestions on how to get listed in Yahoo News? I’ve been trying for a while but I never seem to get there! Appreciate it.

I wanted to thank you for this great read!! I definitely enjoying every little bit of it I have you bookmarked to check out new stuff you post.

Pretty nice post. I just stumbled upon your weblog and wanted to say that I have really enjoyed browsing your blog posts. After all I’ll be subscribing to your feed and I hope you write again soon!
slim iphone 7 plus case

wwe summerslam live streaming
Watch wwe summerslam 2016 results, predictions, Full Show live streaming info here and also buy tickets Online for wwe summerslam 2016

La Liga Live Stream
Watch La Liga Live Streaming, Online El Clasico, Barcelona vs Real Madrid Live Streaming. En vivo Canal Plus HD, BeIN Sports.

Happy New Year 2017
Happy New Year 2017
Send happy new year images, happy new year cards on this new year 2017. happy new year greeting cards, new year pictures, new year wishes, new year SMS, happy new year jokes, messages and more.

olympics medal table 2016
The home of Sports Dust online. Includes live sports coverage, breaking news, results, video, audio and analysis on Football, F1, Cricket, Tennis and all the main world sports.

Mini IPL Live Stream
Watch IPL 2017 Live online, IPL 10 Live Score, IPL Live Streaming 2017, Points Table, Schedule, Results and Highlights. IPL Auction 2017, IPL Opening Ceremony.

Friendship Day Quotes 2016
Find Happy Fathers Day 2016 HD Images, Quotes, SMS, Greetings and Songs. Also Pictures and Wishes for Best Friends. Best Wallpaper, Wishes and Pictures you can find.

Raksha Bandhan 2016 Images
Find Happy Raksha Bandhan Day 2016 Images, Quotes, Greetings and Songs. Also Pictures and Wishes for your Brother or Sister. Best Presents, Gifts Ideas and Quotes Poems.

Independence Day India
Happy Independence Day 4th of July 2016 images and pictures. Watch fireworks, events and celebrations Here

In my opinion about technical people is that they are very genius and technical minded people they do work hard about their technical work. I totally agree with your post about "Technical documents should be reviewed by technical people". Get help with assignments

As per my notion this is one of the best articles I have ever read. This provides me a lot of information and also enhances the knowledge of readers. This makes me feel cool. is thankful to you for sharing such kind information. you can find more Research Report Writing from here. I am quite happy to post on this website. I personally suggest all the aspirants to contribute this by sharing and commenting on it.

Awesome blog. I enjoyed reading your articles. This is truly a great read for me. I have bookmarked it and I am looking forward to reading new articles. Keep up the good work!
nyc flowers


Add new comment