Engineer vs Seasoned Technical Writer?

Engineer vs Seasoned Technical Writer?

Make no mistake; engineers are a key component to turning out quality documentation for your end-users, but are they the best resource? An age-old question that many companies have dealt with for many-a-moon.

Now, to be clear, technical writing incorporates a few basic concepts. First, the writer must have the ability to digest and understand the “technical” information and jargon presented to them; usually by engineers. Secondly, the technical writer should be able to regurgitate that technical information in the form of clear, concise documentation. Lastly, the technical writer must ensure that all documentation meets a standardized set of rules (to ensure all documentation leaving the company has the same look, feel and branding). Sounds easy enough, doesn’t it?

More often than not, engineers are tasked with writing their own procedures, manuals, reports, etc., for “their” own project. Now imagine a company with 5 engineers, 50 engineers or even 1,000 engineers. Each engineer is responsible for putting out their own documentation. This could potentially mean that your company is now represented 1,000 different ways with information presented in multiple formats. Each documentation set incorporating each engineer’s vision for quality documentation.

Engineers are not writers and if you asked most of them how they like writing, I’m confident that most would reply, “I hate it.” Furthermore, engineers have trouble at times writing to their audience’s level and understanding that the folks using their documentation may not have their level of education. Engineers enjoy designing new concepts and finding solutions to problems. In short, engineers do not aspire to be writers and most that I have met in my 25+ years absolutely hate writing!

Seasoned technical writers, on the other hand are worth their weight in gold if they genuinely know their stuff and can provide assistance without the need for constant hand-holding. Let’s face it; there is no substitute for experience, plain and simple. Seasoned technical writers have experience in their chosen industry and can actually speak intelligently about the industry they work in.

Seasoned technical writers should be able to take the engineers information and develop (with the end-user in mind) clear, concise documentation that truly benefits the reader instead of leaving them surrounded by a shroud of doubt and uncertainty. Of course, there will be times when technical writers and engineers must interact but that time is precious and shouldn’t be wasted on hand-holding. Becoming a Subject Matter Expert (SME) is key and mastering the content is paramount!

So…Engineer or Seasoned Technical Writer?

I suppose, at the end of the day that depends on what outcome you want. A seasoned Technical Writer will leave you with professionally developed documentation that checks all the boxes and adheres to a standard set of formatting rules. An engineer, could possibly achieve the same results but at what cost? There’s a good chance the engineer will have to set aside their core competency to provide the documentation. If you can afford to reassign your engineers then I can only say “carry on.” If you’d prefer to save time, money and headaches then I suggest using a Seasoned Technical Writer!

Scott McMillan

Technical Writer and Editor | Cybersecurity Documenter | Process Analyst | Instructional Designer | English Coach | Technical Writing Professor | C.R.A.P. Design Evangelist

6 年

The best of both worlds would be to have engineering and technical writing experience, which is like being bilingual.

JC Suman

Consultant/Adj. Prof./Author

8 年

I agree, that all engineers are not necessarily technical writers. But you are assuming that QA/QC or technical standards are non-existent in all organizations to guide the engineers in producing these documents! Not true!Non-technical professional writers may be better at language use, but documents may not always convey the same meaning as the one written by an engineer.

John Wimer Sr.

Former - Sr. Well Service Products Tec Instructor/Commisioning Supervisor

8 年

Mark, you are so on point, or should I say points?! I tried to help the tech writers at S&S by utilizing my life time of experience and trying to pull info out of the engineers without making them angry because to them many of the questions from tech writers are "just stupid". As an experienced operator and mechanical trainer I usually had a great deal more insight and could relate with the engineer a little better. However we still needed the tech writers as I was not an experienced technical writer.

Fred Plummer

Professional Engineer

8 年

I believe a team of both is required. I always enjoy working with a talented technical writer and the value they add for conisentecy and target audience cannot be denied. But I have never met a technical writer that knows the specific engineering details of each piece of equipment. At my last employ we had a dedicated team of technical writers that understood what you were saying when you corrected details, while guiding me on the latest company standards....win-win.

Mark Swinden

I Help Companies Solve Their Documentation Challenges - Technical Writer, Editor, Communications, Manuals, Processes, Procedures, Proposals, QHSE, Graphic Design, BESS

8 年

Agreed Marty! The challenges are far and wide. We need to get together soon! Thanks...

要查看或添加评论,请登录

Mark Swinden的更多文章

  • NEVER FORGET (or have we)

    NEVER FORGET (or have we)

    Over the next few days, you will undoubtedly hear a ton about the 20th anniversary of the 9|11 terrorists attack on…

    3 条评论
  • Working From Home - It's Not for Everyone

    Working From Home - It's Not for Everyone

    I've been working from home for many years; both as an employee of a company and as a business owner myself. So, if…

    5 条评论
  • Creating Successful Learning Projects with the CIA Method

    Creating Successful Learning Projects with the CIA Method

    When creating any type of learning project, the design of the project is almost as important as the actual content…

    4 条评论
  • It’s Giveaway Time

    It’s Giveaway Time

    OK folks, it’s contest time…and just in time for Christmas! The below pictured Messenger Bag could be yours and all you…

    1 条评论
  • ASTROS 2020 Redemption

    ASTROS 2020 Redemption

    This loss is a hard one to swallow. Astros' fans everywhere would have bet the farm on us winning it all this year…

    27 条评论
  • ATS SUCKS! MY RESUME WINS

    ATS SUCKS! MY RESUME WINS

    ATS SUCKS! For those that aren't familiar with ATS, let me explain. ATS stands for Applicant Tracking System.

    24 条评论
  • That's It, I Quit!

    That's It, I Quit!

    UPDATE AT BOTTOM - 08/30/2019 A lot of people have been asking, "how did you quit"? "What method did you use"? So, I…

    9 条评论
  • Is Poor Documentation Costing Your Company?

    Is Poor Documentation Costing Your Company?

    While most folks cringe at the very mention of the word "documentation", management realizes that it is a necessary…

    2 条评论
  • Documentation Got You Down?

    Documentation Got You Down?

    Ever seem like your equipment or service supporting documentation always takes a back seat? Why is that? Let's face it,…

社区洞察

其他会员也浏览了