http://tc.eserver.org/publisher/Tech_Writer_Voices A listing of works published by Tech Writer Voices in the field of technical communication. en-us Copyright (c) 2005-08 by the EServer. All rights reserved. tclib-editorial@eserver.org (TC Library Editorial Board) webmaster@eserver.org (Geoffrey Sauer) http://tc.eserver.org/images/newlogo.gif http://tc.eserver.org/dir/Tech_Writer_Voices http://tc.eserver.org/35326.html http://tc.eserver.org/35326.html Although getting a job is the focus of the podcast, I also talk about what technical writers do, how they approach a project, how they decide what to create, and how they generate ideas for tasks. Specifically, I talk about about a project people can work on at tech.lds.org. People can start writing help for the project here. http://tc.eserver.org/34570.html http://tc.eserver.org/34570.html Devoted followers stay updated with each new post, podcast, or screencast, eagerly awaiting the next new one. They’re intimately familiar with your content and either comment regularly or regularly return to your site. http://tc.eserver.org/34571.html http://tc.eserver.org/34571.html Devoted followers stay updated with each new post, podcast, or screencast, eagerly awaiting the next new one. They’re intimately familiar with your content and either comment regularly or regularly return to your site. http://tc.eserver.org/34401.html http://tc.eserver.org/34401.html In this podcast, Sarah O’Keefe of Scriptorium Publishing explains the results of their recent survey about the state of structured authoring in technical communication. In the survey, they found that 84% of respondents are either thinking of moving to structured authoring, are in the process of moving to structured authoring, have already adopted structured authoring, or are undecided. Only 16% of respondents said they were not moving to structured authoring. She also discusses other survey results, such as the adoption of DITA and mistakes people make in moving to structured authoring. http://tc.eserver.org/34402.html http://tc.eserver.org/34402.html In this podcast, Mike Hamilton of Madcap Software talks about their phased approach to handling DITA with Flare. In Phase I, you’ll have the ability to import DITA topics and export to webhelp and other targets. In this sense, Flare functions as a transform engine. In Phase 2, you can use Flare for native DITA authoring. Phase 1 is on the cusp of release, but Phase II won’t be available until quarter one of next year. http://tc.eserver.org/33290.html http://tc.eserver.org/33290.html Several weeks ago I wrote about my trip to Brigham Young University-Idaho and the presentation I gave there titled “Debunking the Boredom Myth of Technical Writing.” This podcast is a recording of my presentation. http://tc.eserver.org/32348.html http://tc.eserver.org/32348.html It all comes down to managing and reusing source. Recycling content (chapters, graphics, etc.) is not new. What is new here is the common set of back-end structure in XML form and the fact that more than one set of tools — including small, mission critical custom tools — are explicitly focused on the specific needs of a given project. Reusing and repurposing content is all about improving efficiency: automating, accelerating, and merging applications, systems, and processes. In a multichannel publishing environment, it is critical that content development — source development — and its management are as efficient as possible. http://tc.eserver.org/31893.html http://tc.eserver.org/31893.html In this podcast, Nicky Bleiel says we should talk to as many users as we can — conducting on-site visits, sending surveys, gathering information from Marketing, Support, and other departments — so we can have a better understanding of our users’ needs and the formats and mediums that will work best for them. After completing this audience and needs analysis, we can then go out and create the deliverables that will best serve our users. http://tc.eserver.org/31894.html http://tc.eserver.org/31894.html In this podcast, Joe Sokohl explains how to create user-centered documentation by contacting, observing, and interviewing users to gather information about what types of information they use and the help deliverables they actually want. http://tc.eserver.org/31897.html http://tc.eserver.org/31897.html XML, a way of tagging and structuring your content, can help solve a number of problems, including storing, mining, reusing, and sharing content. XML helps enable the interoperability of information between systems, allowing you to export and import your content from one application to another. XML is behind much of the collaboration and information sharing Web 2.0 technologies, such as RSS (really simple syndication) and blogs. By storing content in XML, technical writers can ensure greater flexibility among technologies for authoring and publishing their content. http://tc.eserver.org/31892.html http://tc.eserver.org/31892.html In this podcast, rich media specialist Todd O’Neill explains how to add video to your training and documentation deliverables. Many technical writers are intimidated by the learning curve, equipment costs, and software they think they need to create video, but actually you can create engaging videos with minimal equipment (e.g., $150 for a Flip video camera) and using software you probably already have (e.g, Windows Movie Maker or iMovie). In this podcast, Todd lays out the basics for those who know nothing about video. He explains the equipment you need, techniques for minimizing editing time, ways to publish the video online, filming techniques to focus on, and creative ways to package your video for your users. http://tc.eserver.org/31896.html http://tc.eserver.org/31896.html Many content management projects fail because organizations are either too focused on tools before properly researching their needs and processes, or because they underestimate the difficulty of migrating and restructuring their content to fit the new content management system. In this podcast, Rahel Bailie explains these pitfalls and what companies can do to avoid them, as well as how companies can climb out of problems they’re currently in. Rahel also talks about how technical communicators can influence business executives and other key stakeholders to make better decisions about content management. http://tc.eserver.org/31895.html http://tc.eserver.org/31895.html IT project teams often need to increase collaboration and communication, but they’re hampered by the cubicle walls and other physical silos they set up in the workplace. These physical obstacles force teams to have frequent meetings — which can be long and inefficient — just to keep each other updated. In this podcast, Emma Hamer talks about both physical and virtual workspaces that project teams need to increase their performance. She also outlines the rationale for teams to gather better feedback from users, project members, and others who aren’t domain experts. http://tc.eserver.org/31737.html http://tc.eserver.org/31737.html Heidi Hansen takes 15 minutes to discuss five books that she read over the past year and published book reviews for. http://tc.eserver.org/31584.html http://tc.eserver.org/31584.html In this podcast, Sarah O’Keefe talks about XSL, Flash, and live blogging. XSL (extensible stylesheet language) is a programming language that transforms XML content into a specific format, such as HTML. She explains what you can do with XSL, why it’s unique, and how the output is created. http://tc.eserver.org/31489.html http://tc.eserver.org/31489.html In this podcast, Stewart talks about the following: the advantages of using a wiki for your technical documentation; why lack of advanced styles in wikis isn’t a major problem; the relentless focus on simplicity with wikis; choosing the right wiki among dozens of wiki engines. http://tc.eserver.org/31490.html http://tc.eserver.org/31490.html In this podcast, I talk with Alan Porter, vice president of Operations at WebWorks, about the Web 2.0 technologies they’re using to reach out to their customer base. In addition to using blogs, wikis, and social networks to connect with customers, WebWorks also uses wikis to facilitate communication and collaboration within their company. http://tc.eserver.org/31488.html http://tc.eserver.org/31488.html In this podcast, Noz Urbina talks about how Web 2.0 is changing the role of the technical communicator into one who drives product R&D and interaction design. The interview covers how the role of the technical communicator has evolved into a diversity of roles; how awareness of user needs and requirements allows technical communicators to get involved in product R&D and user interaction design; and how implementing a backwards flow of data from hundreds of internal and external users changes the role of a technical writer to one who aggregates, synthesizes, and ensures quality rather than one who merely writes. http://tc.eserver.org/31487.html http://tc.eserver.org/31487.html In 2006, Business Objects faced a major challenge. How to migrate over 50,000 pages of unstructured non-topic based documentation it had acquired through rapid growth and acquisitions. The answer was to use DITA to standardize content creation, management, translation and publishing processes company-wide. In this short podcast, David Holmes talks about how he and his team migrated 50,000 unstructured pages to DITA. (DITA is an XML architecture that allows you to better single source your content.) http://tc.eserver.org/31171.html http://tc.eserver.org/31171.html In this podcast, Marlene Martineau of New Dawn Technologies explains why they adopted DITA, how they adopted it, the benefits they're experiencing, and the reasons why she'll never go back. http://tc.eserver.org/31090.html http://tc.eserver.org/31090.html In this podcast, I talk with Theresa Putkey, a usability consultant in Vancouver, about how she transitioned from technical writing into usability. http://tc.eserver.org/30772.html http://tc.eserver.org/30772.html Madcap Flare is one of the most powerful online help authoring tools on the market today. In this podcast, Paul Pehrson, MVP in the Madcap Software forums, talks about Madcap Flare in depth. http://tc.eserver.org/30774.html http://tc.eserver.org/30774.html It turns out that you can get out of a slump or handle pressure situations comfortably by merely changing your facial expressions. I have been trying this over the past several days and have been completely stunned with what happens. http://tc.eserver.org/30773.html http://tc.eserver.org/30773.html We're moving toward a shared network model, where people publish and subscribe. The really appealing sites integrate feeds for a community of users in an invisible, seamless way, making it easy to see what we're all up to. http://tc.eserver.org/30775.html http://tc.eserver.org/30775.html In this podcast, I talk with Bill Albing, founder of KeyContent.org, about the impact of social media on technical communication. Bill talks about different ways social media helps audiences interconnect and interact. Good social media technologies enable professionals to collaborate easily, without being encumbered by complicated technology or even burdened by managing and filtering feeds. Bill explains that the web is more than just a venue for publication -- it's a medium that allows people to interconnect and work/collaborate with information. This is the direction we're moving towards, and technical communicators are starting to integrate social media, such as user forums, directly into their help. http://tc.eserver.org/30463.html http://tc.eserver.org/30463.html Talks about myths, rewards, trends, tips, and issues surrounding blogging and podcasting, especially in terms of how it affects your career. http://tc.eserver.org/30464.html http://tc.eserver.org/30464.html In this audio-visual age, technical writers need an easy way to deliver Flash-based, dynamic screen demos for their help content. http://tc.eserver.org/30465.html http://tc.eserver.org/30465.html R.J. Jacquez, senior product evangelist at Adobe.com, talks about the new Technical Communication Suite from Adobe, which includes RoboHelp 7, Captivate 3, Acrobat 3D version 8, and Framemaker 8. http://tc.eserver.org/30256.html http://tc.eserver.org/30256.html In this podcast, I talk with Svi Ben-Elya about Elephant.org.il. Elephant is an online community he and others created to empower technical communicators in Israel (originally in the city of Yokneam) with relevant salary information to make them more market savvy when they negotiate jobs. http://tc.eserver.org/30255.html http://tc.eserver.org/30255.html In this podcast, I interview Brenda Huettner about strategies for overcoming the top 10 Worst Things Subject Matter Experts Say or Do. http://tc.eserver.org/30005.html http://tc.eserver.org/30005.html A 20 minute monologue about the best way to get information from SMEs--sit by them, permanently if possible. Many IT organizations station the writer remotely from the developers, programmers, and other SMEs, but nothing could be more damaging to getting the information you need. Increasing your proximity also increases the communication you receive. http://tc.eserver.org/29919.html http://tc.eserver.org/29919.html This podcast features Char James-Tanney's June 2007 presentation to the Suncoast Florida STC chapter on virtual ways of communicating. http://tc.eserver.org/29172.html http://tc.eserver.org/29172.html An interview with Kevin Shoesmith about information architecture and the challenge of organizing complicated websites. Shoesmith explains about the importance of metadata, providing user-driven organization, taxonomy vs. folksonomy, the Dublin core, the usability of web menus. http://tc.eserver.org/28849.html http://tc.eserver.org/28849.html David McNamee presented on Vista and Office 2007 to the Suncoast chapter in May 2007. This is a recording of his presentation. He talks about how the purpose of Vista and Office is to help you create, find, and share information more efficiently. http://tc.eserver.org/28795.html http://tc.eserver.org/28795.html This podcast talks about the convergence of web 2.0 with help documentation. It mentions examples of Web 2.0 sites, such as Flickr, Payscale, and Digg, and what help files need to incorporate these same Web 2.0 features. http://tc.eserver.org/28792.html http://tc.eserver.org/28792.html Thom Haller, information architect and director of the Center for Plain Language, talks about how to create a site where users can actually find the information they're looking for. http://tc.eserver.org/28794.html http://tc.eserver.org/28794.html Mike Hamilton from Madcap Software visited the Suncoast chapter in Tampa, Florida, and presented on Flare. In this presentation, he talks about the story behind RoboHelp and Macromedia/Adobe (this blew my mind). He also provides a lot of inside detail on Flare. http://tc.eserver.org/28793.html http://tc.eserver.org/28793.html Rahul Prabhakar talks with us today about ten lessons he has learned as a technical communicator. Rahul is an Indian technical writer living in South Korea working for Samsung. http://tc.eserver.org/28797.html http://tc.eserver.org/28797.html In this podcast, Karen Bachmann, manager of the Usability and User Experience SIG, provides an overview of the user-centered design process. This is part one of a two part series. http://tc.eserver.org/28796.html http://tc.eserver.org/28796.html This is part two of Karen Bachmann's presentation on Usability. In this part of her presentation, Karen gets more in depth with principles and methods for usability. http://tc.eserver.org/28782.html http://tc.eserver.org/28782.html Ann Rockley shares information about an upcoming report on component content management systems her group will be releasing this summer. She also says the Rockley Group is launching a blog to provide quicker information to users in a more interactive way. She talks about the growing presence companies have in the blogosphere, and why they chose WordPress as their blogging tool. http://tc.eserver.org/28784.html http://tc.eserver.org/28784.html Jarrett is one of the authors of User Interface Design and Evaluation, a beginning text for technical communicators moving into user interface design. Jarrett says this book is a perfect start for users looking to add usability basics to their toolbox. She also talks about forms, and how the best forms are ones you barely notice. http://tc.eserver.org/28783.html http://tc.eserver.org/28783.html Thompson talks about his search for the right content management system. He talks about the importance of content reuse across an entire system and having a workflow for editing, reviews, and translation. He discusses AuthorIT as a possible CMS solution. He also gives tips for talking with CMS vendors without being suckered in. http://tc.eserver.org/28790.html http://tc.eserver.org/28790.html Kennedy's presentation on modular writing and reusability was attended by about 200 people. In her presentation, Debbie explained how to chunk content by first looking at different content types: procedures, processes, facts, principles, and so forth. She also mentions a tool called Content Mapper that writers can use to chunk and reuse information through Microsoft Word. http://tc.eserver.org/28778.html http://tc.eserver.org/28778.html Geoff Sauer is one of the founders of tc.eserver.org--the largest online index for all works related to technical communication. The library indexes works by technical communicators in dozens of categories, and allows users to add new works, rank them, and get RSS feeds of specific titles. There are over 25,000 RSS feeds generated on the site and 15,000 visitors each day. http://tc.eserver.org/28786.html http://tc.eserver.org/28786.html Miller, a technical editor at Microsoft interested in multimedia documentation, talks about why multimedia documentation is a growing trend and how writers can get started. He discusses Microsoft's Channel 9 and the human element with instructional screen demos. http://tc.eserver.org/28779.html http://tc.eserver.org/28779.html Shares some trends in the technical communication industry, arguing that writers need to become hyphenated to move forward and be successful in the future. Molisani owns a technical writing staffing company and also produces the Lavacon conference, which is in New Orleans this year, but is traditionally in Hawaii. He says users aren't concerned about polished language these days; they just want accurate, relevant content. http://tc.eserver.org/28789.html http://tc.eserver.org/28789.html Daigle, an Adobe community expert for RoboHelp, shares his reaction to the RoboHelp 7 sneak peak, and also explains the main features RoboHelp 7 will have: drag-and-drop functionality across the topics, double-byte language support for translation, the ability to have multiple topics open at the same time, snippets with graphics, removal of kadov tags, automatic breadcrumbs, and tighter integration with other Adobe products. Daigle speculates on reasons for Adobe's lack of transparency, and comments on the globalization of Adobe's development for RoboHelp. http://tc.eserver.org/28788.html http://tc.eserver.org/28788.html Brazill gives tips for writers who document APIs or write other information for developers. He says that because developers are busy and want to get started, you have to write less and provide more examples. Developers are more goal-oriented than task oriented. He also explains the different levels of API writing. http://tc.eserver.org/28780.html http://tc.eserver.org/28780.html Rob explains how you can use Captivate to create nontraditional e-learning materials, such as on-the-job training, sales and marketing training, or even bird-watching training. You aren't just limited to technical how-to information in screen demos. http://tc.eserver.org/28781.html http://tc.eserver.org/28781.html Abel's presentation on Web 2.0 was the most popular presentation of the STC 2007 conference (at least this is my impression from these interviews). In his presentation, Abel touches upon RSS feeds, wikis, blogs, geospatial positioning, social networking, tagging, podcasts, and other Web 2.0 technologies. He expands here on geospatial positioning and tagging. Abel also explains why he uses a newsletter in addition to a feed for his popular blog, www.thecontentwrangler.com. http://tc.eserver.org/28787.html http://tc.eserver.org/28787.html Bryant talks about videoblogging as a tool for promoting yourself or for communicating with others. She explains the equipment she uses and the process for producing videoblogs. Her book, Videoblogging for Dummies, is available from her website: www.mortaine.com. Bryant also discusses interesting ways lawyers can use videoblogging to educate their clients. http://tc.eserver.org/28785.html http://tc.eserver.org/28785.html Quesenbery is one of the authors of Content and Complexity: Information Design in Technical Communication. Quesenbery explains the five E's -- a simple way to talk about product usability. The five E's are efficient, effective, engaging, error-tolerant, and easy to learn. She elaborates on what it means for a product to be engaging/satisfying. Quesenbery also explains the importance of personas, which she has written about in the Personas Lifecycle by Tamara Adline and John Pruit. She says stories are essential to personas. http://tc.eserver.org/28762.html http://tc.eserver.org/28762.html Keith Hoffman, president of the Madison Wisconsin Four Lakes Chapter, talks with George Hayhoe, editor of the Technical Communication Journal, about the emergence of technical communications in China and Korea, and the forces behind the push for technical communicators. http://tc.eserver.org/28766.html http://tc.eserver.org/28766.html Is technical writing boring? We discuss a post that spawned a lot of comments and exchanges. We also talk about an article on information architecture in the Tech Comm journal. http://tc.eserver.org/28764.html http://tc.eserver.org/28764.html Discusses a number of trends in the technical writing world, particularly the need to make help more human by adopting conversational tones and addressing the angry/frantic state of the user. http://tc.eserver.org/28763.html http://tc.eserver.org/28763.html I talk with Katherine (Kit) Brown, Brenda Huettner, and Char James-Tanny about their latest book, Managing Virtual Teams: Getting the Most from Wikis, Blogs, and Other Collaborative Tools. http://tc.eserver.org/28769.html http://tc.eserver.org/28769.html An introduction to the new co-host, competition entries, an interesting entry from Microsoft, audio in instructions, screen demos, the STC annual conference, other technical communication tools, wikis, blogs, NetVibes, Get me the Geeks video, David Pogue, Walt Mossberg, and more. http://tc.eserver.org/28767.html http://tc.eserver.org/28767.html In this podcast, Heidi and Tom talk about online communities, member maps, virtual chats, Sparkpeople, Intercom, and more. http://tc.eserver.org/28765.html http://tc.eserver.org/28765.html In this special presentation podcast, Susan Burton, executive director of the STC, provides an inside, in-depth look at the most pressing issues and challenges the STC faces. She also explains the initiatives underway to reshape the STC and provide more value to members. http://tc.eserver.org/28749.html http://tc.eserver.org/28749.html This is a presentation titled 'Creating Help in the Web 2.0 Age' that Neil Perlin gave to the Suncoast Chapter in Tampa, Florida in February 2007. Neil talks about what Web 2.0 is, and how help can be delivered on the fly according to specific user requests. http://tc.eserver.org/28753.html http://tc.eserver.org/28753.html This is presentation Keith Hoffman gave on writing and Web 2.0 at the University of Wisconsin. If you recall, Keith wrote the feature article in January's Intercom on Web 2.0. http://tc.eserver.org/28754.html http://tc.eserver.org/28754.html In this podcast, Katriel Reichman, a technical writer at Method M in Jerusalem, Israel, talks in-depth about how to use wikis for documentation. http://tc.eserver.org/28548.html http://tc.eserver.org/28548.html In this week's Tech Writer Voices podcast, Heidi and I talk about some innovative research from Microsoft, Word 2007, convincing upper management you're not a cost, focusing on information users actually want, tool versus industry experience, the curse of knowledge, the slow movement, and a tip for handling your e-mail inbox. http://tc.eserver.org/28743.html http://tc.eserver.org/28743.html Tech Writer Voices is a podcast specifically intended for technical writers. Podcasts include all topics relevant to the profession of technical writing, from single sourcing to collaborating with SMEs.