Key Concept Archive

For more information about how our library science background (and our love of all things metadata) guides the way we catalog information, see the Techcomm and Arbortext Resources page.

Inclusive vs Exclusive Language and Corporate Culture

The U.S. General Services Administration (GSA.gov) website recently published an article about how they customized a Slack bot to gently correct people who use the word “guys”. The GSA has a big job and a big audience and they wanted to make sure that the people writing content for that audience were aware…

What happens when you skimp on documentation?

In the TC Dojo last week we found out: Your company is at risk of debilitating lawsuits that, in the worst case, can put you out of business. Joe Devney, forensic linguist, editor, non-fiction writer, and previous STC chapter chair shared stories of companies who delivered insufficient, poorly-written documentation or who failed…

Herding Tigers – How Salesforce Let Go of Inline Links

Did you know that every manually-coded inline link comes at a cost? Did you know that customers don’t use them nearly as often as technical writers do? Join us to learn how we let go of manual links as a primary navigation tool, and as a result spend more time…

Fit the most information in the least amount of space

Writing instructions for products you can hold in your hand isn’t the same as writing for the software industry. In many cases, you’re creating paper documents to fit in small boxes, so page layouts matter. This session addresses the unique needs of writers in the manufacturing industry, but these tips…

Where Are They Now?

Summary: Stories of long-term Arbortext customers who are realizing the full potential of their solutions. There’s a software side to dynamic information delivery. We know this. Customers who have seen IBM talk have come to us and said “Sure, they can get there, but can I?” What if you’re not…

Why go to XML for product information?

When Management decides to go to an XML publishing system, it’s not always clear to the authoring and editing staff why the decision was made. Ever wonder why they choose to go this route? In this presentation, we talk about some of the reasons why you might go away from…

You Don’t Have to Build Software to Do DITA

This is a success story. Medtronic ENT deployed a brand-new DITA solution, employing all the traditional strategies and best practices for DITA such as specializing only where absolutely necessary and adopting minimalist approach to topic-based authoring. As a global organization, they had a lot of resources to draw upon when…

Will Work For Equity – the World of Startups

Are you considering joining a startup? At Silicon Valley Code Camp 2011, Sean Murphy, CEO at SKMurphy, hosted a panel outlining important tips and issues to consider if you are investing your time in a startup. This session explored: difference between employees, contractors, alliances, partners and co-owners; defining the key…