Highlights the challenges of deploying complex enterprise applications with incomplete, unclear documentation, emphasising the need for accurate installation guides.
Why is it that vendors insist on developers staying up all night to write installation documentation for a 40 component on 19 server installation? Do they not realize that this is not the best way to have your documentation produced? What about the image that it presents to the customer, or the impact of someone actually following said documentation!
That has been one of my tasks over the last week. I stalling a complex enterprise solution from documentation written at four in the morning by a very tired developer. Needless to say it has been difficult and my copy of the documentation is now full of notes to take back to the vendor. Notes like “What is this?” or “Which config files are you referring to?” and “In the config file I can find, what ’exactly’ do I need to change?”
It does not help that the application is not complete…
We are trying to follow cryptic documentation for an application that is not complete to install two instances with four environments per instance and twenty servers per instance and as many as twenty-five applications per server!
Hmm… Fun.
Technorati Tags: Fail
No related videos found.
If you've made it this far, it's worth connecting with our principal consultant and coach, Martin Hinshelwood, for a 30-minute 'ask me anything' call.
We partner with businesses across diverse industries, including finance, insurance, healthcare, pharmaceuticals, technology, engineering, transportation, hospitality, entertainment, legal, government, and military sectors.
Alignment Healthcare
YearUp.org
Lean SA
Genus Breeding Ltd
Microsoft
Milliman
Healthgrades
Slaughter and May
ProgramUtvikling
Boxit Document Solutions
Boeing
Sage
MacDonald Humfrey (Automation) Ltd.
Xceptor - Process and Data Automation
Cognizant Microsoft Business Group (MBG)
Schlumberger
Kongsberg Maritime
NIT A/S
Washington Department of Transport
Ghana Police Service
Nottingham County Council
Department of Work and Pensions (UK)
Royal Air Force
New Hampshire Supreme Court
Qualco
Milliman
YearUp.org
ALS Life Sciences
Workday
Alignment Healthcare