DZone
Thanks for visiting DZone today,
Edit Profile
  • Manage Email Subscriptions
  • How to Post to DZone
  • Article Submission Guidelines
Sign Out View Profile
  • Post an Article
  • Manage My Drafts
Over 2 million developers have joined DZone.
Log In / Join
Refcards Trend Reports Events Over 2 million developers have joined DZone. Join Today! Thanks for visiting DZone today,
Edit Profile Manage Email Subscriptions Moderation Admin Console How to Post to DZone Article Submission Guidelines
View Profile
Sign Out
Refcards
Trend Reports
Events
Zones
Culture and Methodologies Agile Career Development Methodologies Team Management
Data Engineering AI/ML Big Data Data Databases IoT
Software Design and Architecture Cloud Architecture Containers Integration Microservices Performance Security
Coding Frameworks Java JavaScript Languages Tools
Testing, Deployment, and Maintenance Deployment DevOps and CI/CD Maintenance Monitoring and Observability Testing, Tools, and Frameworks
Partner Zones AWS Cloud
by AWS Developer Relations
Culture and Methodologies
Agile Career Development Methodologies Team Management
Data Engineering
AI/ML Big Data Data Databases IoT
Software Design and Architecture
Cloud Architecture Containers Integration Microservices Performance Security
Coding
Frameworks Java JavaScript Languages Tools
Testing, Deployment, and Maintenance
Deployment DevOps and CI/CD Maintenance Monitoring and Observability Testing, Tools, and Frameworks
Partner Zones
AWS Cloud
by AWS Developer Relations
The Latest "Software Integration: The Intersection of APIs, Microservices, and Cloud-Based Systems" Trend Report
Get the report
  1. DZone
  2. Culture and Methodologies
  3. Career Development
  4. Developer Career Patterns: The Technical Communicator

Developer Career Patterns: The Technical Communicator

Technical communicators fulfill an essential function in modern software development: part developer and information architect, part writer, but all-in user advocate and master of the document.

Rodrigo Kyle Mehren user avatar by
Rodrigo Kyle Mehren
·
Jan. 23, 16 · Analysis
Like (4)
Save
Tweet
Share
3.98K Views

Join the DZone community and get the full member experience.

Join For Free

What is a technical communicator? In a phrase, an expert writer who talks about software, with software.

The technical communicator's concern is the endpoint, the moment of interaction between the user and the system. It's what some might call "the moment of truth" in software development because in the end, if the software fails there—no matter what the reason, the sophistication of the algorithm, the cadence of the process, the oversight unseen by the end user—it has failed totally.  

Personality Traits

Precision. Clarity. Insight. Correctness. 

These aren't words; they're an immutable code programmed into the writer. 

While the programmer works in C#, or JavaScript, et cetera, the Tech Comm's skillset will include a working knowledge of the project's languages, tools, and architecture, but home-in on using the written word as their primary language.

The Curriculum

  • The Microsoft Manual of Style 
    The authoritative document of technical style. Everyone should have a copy.

  • The Chicago Manual of Style
    For questions not answered by the MSTP, Chicago provides more guidance on usage and convention.

  • The Handbook of Technical Writing (Alread)
    Covers document formats, including not just documentation of software but internal project communications like strategy and planning documents.

  • Technical Editing (Eaton and Rude)
    For revising documents, there's no better guide for the information architecture, if you will, of documentation.

The Artifacts

Primarily documentation: manuals and user guides. Additionally, UI text, troubleshooting documents, and occaisionally one-to-one support.

Entry-level Roles and Positions

Technical Writer I positions are so-named and easy to find. It's a matter of which industry you want to work in more than anything else.

The West Coast of the U.S. has two main influences: Start-ups, and the giants of Amazon and Microsoft.

The East Coast is a little different in my perception. There are still sizable technology companies, such as Red Hat, but you'll also find a huge concentration of the Defence Industry.

State of the Industry

Anecdotally, the prospects are strongest for hybrid programmer/writer. 

Employment of technical writers is projected to grow 10 percent from 2014 to 2024, faster than the average for all occupations. Employment growth will be driven by the continuing expansion of scientific and technical products and by growth in Web-based product support. Job opportunities, especially for applicants with technical skills, are expected to be good.
—Bureau of Labor StatisticsOccupational Outlook Handbook

Career Progression

Technical communicators are skilled at relaying the benefits of a project, and have some grip on the technical features as well.

As such, they have the ability to communicate with developers and executives, and because of their access to both audiences, the potential to go beyond a single role or type of role is great.

Guard Conditions

Some technical writers hail from the College of Fine Arts, others from Engineering.

For the former, it's important to bone-up on the technical: the tech comm should have at least some experience in hands-on development, even if they stay primarily focused on writing.

For the latter, it's important to understand that English (or other language of publication) is just as sophisticated a code for the representation of information.

Software development career

Opinions expressed by DZone contributors are their own.

Popular on DZone

  • Container Security: Don't Let Your Guard Down
  • Master Spring Boot 3 With GraalVM Native Image
  • How Chat GPT-3 Changed the Life of Young DevOps Engineers
  • Documentation 101: How to Properly Document Your Cloud Infrastructure Project

Comments

Partner Resources

X

ABOUT US

  • About DZone
  • Send feedback
  • Careers
  • Sitemap

ADVERTISE

  • Advertise with DZone

CONTRIBUTE ON DZONE

  • Article Submission Guidelines
  • Become a Contributor
  • Visit the Writers' Zone

LEGAL

  • Terms of Service
  • Privacy Policy

CONTACT US

  • 600 Park Offices Drive
  • Suite 300
  • Durham, NC 27709
  • support@dzone.com
  • +1 (919) 678-0300

Let's be friends: