Techniques

Event report: Structured content webinar

On September 20, 2018 Nenad Furtula presented an overview of the principles and value of structured content. Nenad, a partner and VP Sales and Marketing at Bluestream Database Software, has been working with Extensible Markup Language (XML) for over 15 years. Structured vs. unstructured content Unstructured content is written as a single, complete unit (for…

September 20 – Webinar event: Structured content

A current job posting for a technical writer calls for experience “using a recognized document content management system (CMS), writing/editing in XML, DITA.” Our next webinar will explore the theory and practice behind that job requirement. On Thursday, September 20, Nenad Furtula will present a webinar titled “Why ‛Intelligent Content’?” Nenad will discuss how the…

How to hire a technical writer

How to hire a technical writer

Why hire a technical writer? In any business, a technical writer can enhance your communications, both printed and online, and make sure that they reflect your best thinking and best practices. A skilled technical writer understands audience, both internal and external, and the way content and format work together to improve communication, productivity, and effectiveness…

Writing a news release

Writing a news release

The tech writing world rarely intersects with the news world, but news writing is still a handy skill to have. You might find yourself in a communications role – having to write a news release or announcement for a website, for example. Traditionally, the purpose of a news release was to attract the interest of a…

How much does a tech writer need to know?

How much does a tech writer need to know?

There’s an interesting tension in technical writing between knowing and not knowing. Tom Johnson, who blogs at www.idratherbewriting.com, tackled this question in an article on learner perspective. This is my take on the question of how much tech writers need to know about their subject matter. Knowing everything about a software application that you’re documenting…

Email or e-mail? How to create a style guide

Email or e-mail? How to create a style guide

Style guides are critical to our work as writers. They tell us how to spell words (Canadian or US?), how to hyphenate (email or e-mail?), how to punctuate (serial comma: yes or no?), how to capitalize (internet or Internet?), and how to write step-by-step procedures (is it “Click Enter” or “Select Enter”?). They lay out…

Ten Tips for Great Training

Ten Tips for Great Training

By Stephen Gauer You’re written the user guides and online help for the new application and now the client needs someone to train the staff. Why not take the plunge and add training to your skill set? Here are some tips from my 25 years of training: Tip #1: write a detailed script In the…

Book Review of the Global English Style Guide

Annotated copy of The Global English Style Guide

By Serena Beck, Membership Manager As an author of many internal style guides, I can appreciate the amount of effort and time required to create a style guide and ensure it’s followed. I have a good eye for detail and enjoy making the documentation I write consistent. I’ve been a technical writer for 11 years,…

Online Portfolios for Technical Writers

Online Portfolios for Technical Writers

If you’re starting your career as a technical writer, you should have an online portfolio to showcase your work. Your online portfolio should have a URL you can add to your LinkedIn profile, and be included on your resume, or pasted into the appropriate space on the online job application form. The goal of your…

Using Social Media for Your Job Search

Using Social Media for Your Job Search

Social media is one of the most useful tools within today’s competitive job market. Building a professional online presence and leveraging job-search features on social networking sites are powerful ways to access new and diverse opportunities. In the midst of my own career transition into technical writing, I have been actively searching for jobs and…

Menu