Embedded Systems Conference
Breaking News
Newest First | Oldest First | Threaded View
User Rank
Re: Is it training or documentation
dfarbey   5/1/2014 6:07:03 AM
You highlight several important issues around documentation and training, and as someone who is responsible for providing information I recognise the problems you describe only too well. People with jobs like mine - often known as technical communicators, or technical writers, or technical authors - would love to provide information that supports user tasks, rather than information that just describes the product, but there are often obstacles that stop that from happening. For example:

1. Some companies see technical communication as a necessary evil, and teams are under-resourced in terms of staff, tools, and access to information

2. Some companies see technical communication as a cost centre, part of product development, and so it's kept separate from Training, which is seen as a revenue source. The result is often that there are two teams trying to provide parrallel information to customers, duplicating efforts and wasting resources.

3. The best sources for understanding user expectations and therefore producing documentation that supports users are from user research. This research is often undertaken and owned by a marketing department that doesn't see the need to share. Data about what features are least well understood - the features that need to be explained more fully in training or documentation - could be gathered by reviewing calls to Customer Service, but once again, it is rare for this information to be shared.

User Rank
Re: training vs documention
AZskibum   4/27/2014 8:07:34 AM
Training and documentation serve different purposes and both are needed, especially for new users or even for experienced users who are being introduced to a methodology or major tool feature that is new to them.

Those multi-day offsite training courses in a room full of workstations are expensive, but can be incredibly valuable. The knowledge & experience gained by using the tool in such a focused environment with an expert instructor cannot always be duplicated by simply reading the documentation and trying things on your own.

User Rank
I read specifications
_hm   4/26/2014 4:33:15 PM
I first like to read specifications  of every new tool or device I encounter. So this way, I know the most capabilites. Reading documentation is sometime time demanding and not many family member have patience. So manual I read as need basis.


User Rank
Re: training vs documention
junko.yoshida   4/25/2014 6:29:08 PM
I agree, Sanjib. This article illustrates the crux of the issue -- documentaions? training? or both? -- rather eloquantly. 

I guess the fundamental human behavior isn't that much different -- whether one embarks of using a brand new flash light or a new EDA tool. 

User Rank
training vs documention
Sanjib.A   4/25/2014 12:41:50 PM
First of all...a very nice article!! I am a user of EDA tools. I have not spent much time in reading the manual, but while reading through this article I realized that I might not be using the tool most efficiently. I think training is absolutely needed to start with. If the user works with an EDA tool frequently, training should be enough to start with. When ever I get stuck, I ask some expert users in my organization. That is quick...but if nobody is around to help, the manuals get handy then...only wish that the manuals are presented in a way which does not bore the user. :-)


NASA's Orion Flight Software Production Systems Manager Darrel G. Raines joins Planet Analog Editor Steve Taranovich and Embedded.com Editor Max Maxfield to talk about embedded flight software used in Orion Spacecraft, part of NASA's Mars mission. Live radio show and live chat. Get your questions ready.
Brought to you by

Top Comments of the Week
Like Us on Facebook

Datasheets.com Parts Search

185 million searchable parts
(please enter a part number or hit search to begin)
Special Video Section
The LTC®4015 is a complete synchronous buck controller/ ...
The LTC®2983 measures a wide variety of temperature sensors ...
The LTC®3886 is a dual PolyPhase DC/DC synchronous ...
The LT®3042 is a high performance low dropout linear ...
Chwan-Jye Foo (C.J Foo), product marketing manager for ...
The LT®3752/LT3752-1 are current mode PWM controllers ...
LED lighting is an important feature in today’s and future ...
Active balancing of series connected battery stacks exists ...
After a four-year absence, Infineon returns to Mobile World ...
A laptop’s 65-watt adapter can be made 6 times smaller and ...
An industry network should have device and data security at ...
The LTC2975 is a four-channel PMBus Power System Manager ...
In this video, a new high speed CMOS output comparator ...
The LT8640 is a 42V, 5A synchronous step-down regulator ...
The LTC2000 high-speed DAC has low noise and excellent ...
How do you protect the load and ensure output continues to ...
General-purpose DACs have applications in instrumentation, ...
Linear Technology demonstrates its latest measurement ...
Demos from Maxim Integrated at Electronica 2014 show ...
Bosch CEO Stefan Finkbeiner shows off latest combo and ...