san francisco

0 0 Clarins Spring Beauty PreviewIf you look at the surveys and other data collected about tool usage and priorities in the technical communication field, it's impossible not to acknowledge FrameMaker as one of the most common tools. Year after year it appears at the top of the charts, and print publishing remains a high...  

0 0 Simplifying my life and writing I'm a technical writer based in the California San Francisco Bay area. Topics I write about on this blog include technical writing, authoring and publishing tools, API documentation, tech comm trends, visual communication, technical writing career advice, information architecture and...  

0 0 Guest post -- The effects of terminology consistency on the reader's comprehension and attitudeFrom a cognitive perspective, what do we know about the effects of terminology consistency on how our readers understand and 'like' our documentation? In this guest post, Yves Pierrot explores how the cognitive aspects of memory, reading, text comprehension, and search strategies potentially...  

0 0 Upcoming 2017 Write the Docs Conference in PortlandThis year I'm planning to attend the 2017 Write the Docs conference in Portland. The conference takes place May 14-16 and draws about 400 people who come together for three days 'to explore the art and science of documentation'. I'll be presenting a short talk on doc navigation best practices....  

0 0 Adobe FrameMaker 2017 -- time, tools, and the tech writer's focus on contentAdobe FrameMaker has a new release (called Adobe FrameMaker 2017) that has a ton of improvements toward simplicity and usability. Some of the new features include new responsive HTML5 layouts, auto-complete search, more intuitive menus for authors, and more. Tools like FrameMaker that allow...  

0 0 Write the Docs Podcast Episode 4 -- Continuous Integration and Docs as CodeEpisode 4 of the Write the Docs podcast is now available. In this episode, we talk about continuous integration strategies for docs (for style, screenshots, and REST calls). We also dive into discussions around docs as code, including how to encourage developer collaboration, how to stay...  

0 0 #StyleForAll: Meet Isabel Hendrix Meet Isabel Hendrix, Social Media Maven, Business Co-Owner, & Blogger Hometown: San Francisco, CA Hobbies: Organizing stuff, belly dancing, dying her hair every color of the rainbow You're the co-owner of the online clothing shop Tunnel Vision. What's been the most surprising thing...  

0 0 Guest Post -- MadCap Central: A Review for Companies Delivering Technical Communication ServicesThe following is a guest post from Michał Skowron and Jakub Wiśniewski, two technical writers working for 3di. 3di is a company providing technical authoring, translation and localization services. In this short review, Skowron and Wiśniewski evaluate MadCap Central, a new product from MadCap...  

0 0 Guest post: Design choices for organizing API reference content with other documentationIn this guest post, Derric Gilling, CEO at Moesif, explores various design choices for organizing API reference content in relation to the rest of your programming tutorials. He looks at three different strategies: (1) Centralized docs with separate API reference, (2) Centralized docs combined...  

0 0 How do you learn what you need to learn to be successful as a technical writer?Keeping pace with new technology and information is a core challenge for tech writers. You can divide the needed knowledge into four areas: product, technology, user, and industry domains. To limit the scope in each domain, filter by the users' tasks. To find time for the learning, implement...  

0 0 Recording of User-Centered Design Principles for Organizing DocumentationI recently presented to the STC Twin Cities chapter on User-centered Design Principles for Organizing Documentation. When organizing your documentation, such as arranging navigation titles, workflows, or other wayfinding features, you can apply universal design principles to make your content...  

0 0 Technical Writing Trends and Predictions for 2017My 2016 technical writing trends/predictions turned out to be pretty accurate. For 2017 technical writing trends, I'm predicting that more technical writers turn to Github in their documentation workflows. This trend applies mainly to companies where programming technical writers work with...  

0 0 Write the Docs Podcast #3 - Trends for 2017In this episode of the Write the Docs podcast, we discuss top technical writing trends for 2017. Chris Ward discusses how more technical writers are interacting with support groups, and even being embedded within support departments. Jared Morgan discusses how docs are being planned for...  

0 0 Recording: Modern Technical Writing, by Andrew Etter (STC Silicon Valley chapter) can view the slides in PDF here: If you'd like more, you can also watch a similar presentation Andrew gave to the Write the Docs San Francisco meetup here. Get new posts delivered straight to your inbox. Powered by ZipRecruiter I'm a technical writer based in the California San...  

0 0 Simplified Technical English and HyperSTE Powered by ZipRecruiter I'm a technical writer based in the California San Francisco Bay area. Topics I write about on this blog include technical writing, authoring and publishing tools, API documentation, tech comm trends, visual communication, technical writing career advice,...  

0 0 Swagger presentation recording -- Harnessing the Chi of Swagger in your REST API documentationRecently I gave a presentation on Swagger as part of the TC Dojo webinar series. If you missed the presentation, you can view the Swagger recording here. Here's a description of my Swagger presentation, which was titled "Harnessing the Chi of Swagger in your REST API documentation": Frequently...  

0 0 My top 3 posts of 2016 are all Swagger-related -- lessons learned from 2016 analyticsThis past year the stats on my blog showed some surprising results. From about mid-2016 on through the present, there was a notably upward trend in page views. I attribute the upward trend primarily to some posts on Swagger. The larger trend is that all top posts on my site could be classified...  

0 0 Our Wedding Solo Lisa In fact, I had an intense dream about watching a zombie apocalypse TV show in which the protagonist, a technical writer who lived in San Francisco, had to make her way home just as the zombie outbreak was starting. It was a full-on television pilot playing in my head! Walking Dead meets...  

0 0 Madcap Central -- a first look at Madcap's new cloud-based collaboration and publishing solutionMadcap Central, recently released in early January, is a new cloud-based collaboration and publishing solution for tech docs from Madcap Software. Madcap Central allows you to configure and deploy Flare builds from a central server. You can also manage tasks, teams, users, and other details...  

0 0 Adobe FrameMaker -- Evaluating FrameMaker's responsive HTML5 outputIf you look at the surveys and other data collected about tool usage and priorities in the technical communication field, it's impossible not to acknowledge FrameMaker as one of the most common tools. Year after year it appears at the top of the charts, and print publishing remains a high...  

1 2 3 4 5 6 7 8 9