san francisco

0 0 Following instructions involves learning a new language -- adventures with Tinker Crate projectsI 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 Tutorial on converting an HTML site into a Jekyll themeI recently added a tutorial on converting an HTML site into a Jekyll theme. This tutorial shows how easy it is to make any HTML site Jekyll ready with just a few tags. Creating Jekyll themes is one of the aspects of Jekyll I enjoy the most. You can view the tutorial here: Convert an HTML site...  

0 0 The Best High-Street Stores For All Your Spring/Summer Wardrobe Essentials "Over 40 years ago, it started exclusively as a jeans shop in San Francisco." As a slew of big-name, small-ticket retailers upped their game in the denim department with edgy cuts and trend-led colours, Gap stuck to what it knows best: classic jeans. "Denim is such a foundation of any...  

0 0 Write the Docs Podcast app now on Fire TV, and the importance of testing your docs with sample appsThe Write the Docs Podcast app is now on Fire TV. If you have a Fire TV, search for write the docs or even just technical writing in the Amazon Appstore and you'll find it. I created this app to better understand the Android app template I was documenting. This app template, called Fire App...  

0 0 Nana Joes Granola Blog fête à fête Based in San Francisco, founder Michelle Pusateri and her team make each small batch by hand. The grain-free Urban Blend ($11; 10oz) is an awesome blend of crispy coconut, chewy dried fruit, seeds and nuts. There is no refined sugar; the amount of organic maple syrup is just right, not too...  

0 0 "So, Now What?" And Other Top Questions Answered What will happen to your employees? Our incredible team across our three office locations in San Francisco, Los Angeles, and Pittsburgh, PA, as well as at our first store in Austin, TX, will remain intact and continue to lead ModCloth into the future. Will your values, specifically your...  

0 0 Moved my API doc site into separate repoI recently moved my API doc course into a separate repo. Previously, I had the material inside my main site in its own collection. But I wanted to completely separate out the site into its own repo, with its own theme and configuration file and other settings. This will allow me to more easily...  

0 0 Tutorials versus docs -- why you need bothThere's a new tutorials section in the Jekyll docs. I actually added this new section and contributed a couple of tutorials there. I initially did this because I wanted to become more familiar with github workflows with open source projects, but I also just like playing around with Jekyll. In...  

0 0 Amazon begins pilot with voice-interactive user manualsAmazon's technical writers are taking their manuals to the next level using voice-interactive features with Alexa. The guides are still delivered through traditional means (PDF and web), but these guides now include an additional interactive voice enhancement that users can optionally leverage...  

0 0 Clarins Spring Beauty PreviewThursday Two weeks ago I had the pleasure of attending the Clarins media breakfast at the Four Seasons in San Francisco. I got a chance to catch up with my dear friend Natalie from Coquette while learning about the latest spring launches from the venerable Parisian beauty brand. Image...  

0 0 Simplifying my life and writingFor a while now I've wanted to simplify my life. When I tell this to people, almost everyone can relate. But the move toward simplicity isn't just about removing busy-ness. Simplicity lets you focus on the things you actually want to do, rather than those things you feel obligated to do but...  

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...  

1 2 3 4 5 6 7 8 9