I am seeing a trend here, where TW=BA=UX. Multitalented Technical Writers are now becoming more involved within organizations. They must know the business as well as a Business Analysts, and they are also becoming our Usability Experts. They are a versatile, adaptable, resourceful group of writers, mainly because their function is in knowledge transfer. They have become so involved in the business processes that they are now our Knowledge Managers with sub-titles of Technical Writer, Business Analyst, and Usability Expert
Let’s first define a Technical Writer (TW), a Business Analyst (BA), and a Usability Expert (UX). Checkout this comparison chart:
Tasks required | TW | BA | UX |
Understand the business | Writes about business models | Analyses the business model | Uses business models |
Transfer knowledge | Ability to communicate | Ability to communicate | Ability to communicate |
Work across various functions/disciplines | Gathers information | Gathers information | Gathers information |
Information Architect | Designs a user interface (UI) structure | Designs a interface (UI) structure | Designs a user interface (UI) structure |
Governance of information | Handles data or information | Handles data or information | Presentation of data or information |
The TW translates the business terms and technical information into simple easy to understand terms and guidelines so that the project can be accomplished.
The BA translates business policies, strategies, or regulations into system requirements for a project and takes a course of action to ensure the completion of the project.
The UX translates business requirements into information retrieval by ensuring the right data is captured or presented through an defined process.
All three roles have to:
- Analyze and document the current business processes to ensure that the content is understood by the project stakeholders.
- Create and present process flows, information architecture, site maps and prototypes for complex applications.
- Identify and document future business processes including opportunities for process improvements.
- Understand the features, functions, and capabilities of applications or services or products in order to achieve high performance goals.
- Gather business requirements using different requirements gathering techniques (e.g. interviews, surveys, meetings, etc.).
- Analyze and document business requirements using specific modeling or case tools.
- Partake in tracking changes to the project.
- Work with the business stakeholders, i.e., graphic designers, web developers, business analysts and software engineers.
- Translate business requirements into technical and functional specifications.
- Collaborate with the technical resources or any subject matter expert to gather specific (data or design) information.
- Conduct, coordinate, and perform user acceptance tests, user walk-through sessions, and other ways to test the designs as well as create test plans to ensure adherence to specifications.
- Act as a liaison between the IT project team and the business stakeholders.
- Translating client goals into user-centered designs.
- Write user-friendly text for on-screen instructions, headings, button labels, link text and other matter that have an effect on a user’s experience .
- Create guidelines and sharing best practices.
The role of the technical writer is ever evolving and becoming more relevant every day.
Hello Theresa ,
Greetings !!
I like the differences you have pointed out here to define working of TW & BA.
But being a technical writer in a medium scale company, I personally feel that role of TW changes according to the company profile[Large/small]. e.g. In my company I am the only one technical writer who has done the documents such as “Functional Requirement Specification”, API Documentation as well as Information Architectures.
Coming back to my actual point,
I am currently handling ‘Business Requirements’ document where i have no idea from where to start with. Could you pl throw a light on this topic?
Your experience will be helpful to upgrade my knowledge in technical writing.
Kind Regards,
Radha
Hi Radha :-D..yes being a TW involves a lot of work and you end up wearing many hats. Take a look at this post where I’ve provided a break-down of the Requirements Document https://staging.management.org/blogs/communications/2011/08/08/building-a-requirements-document/
If you have more specific questions after reading the post, please let me know. Thank you. Theresa (https://www.smashwords.com/books/search?query=a+quick+guide+to+technical+writing)
Good Question!! – There is no straight answer, but this is what i generally do. I carry a notebook w/me (or use my iphone) and when I get an idea, I jot it down w/a sentence or two. When I sit to write, I’ll refer to my notes, get an idea and begin to write anything. When i can’t think of anything more to write, I walk away and return later and reread what i wrote and I usually change it and sometimes even change the topic because I’ll get excited about some other idea. Don’t laugh :-D. This may sound like an awkward method, but that’s my technique. My suggestion to you is to write when you are in the mood; do not force it. Do your mind-mapping and your words will flow. Hope this helped in some way.
I’ve learned that it all depends on your organization. All TWs know that you are more than likely going to wear many hats where ever you work. I had a manager that assigned me to a business proposal task. I was told I was going to write the proposal, not knowing a thing about business writing, much less proposals. I ended up getting through it, but had to learn along the way.
I used to hate the different hats but as time has gone on, I’ve discovered I like it. It gives me vast skills in many different areas and is helping me to decide the next direction to take my career.
Good article!
Thank you Evin. I too had to wear many hats and loved it because I was always learning and never bored. TWs are more important now than ever because of our adaptability and perseverance. Good Luck on finding which hat(s) fits you best.