san francisco

0 0 Pottery Barn Debuts Home Collaboration with Emily Current and Meritt ElliottIn this episode of the Write the Docs podcast, we explore where technical writers belong in an organization. Is tech comm best placed within engineering, marketing, product management, or another group? We also talk about strategies for doc navigation, in particular, the merits of inline links...  

0 0 Don't Be Shy—Tell 'em How You Really Feel With the Goyard Voltaire Smile Tote This tote retails for $1,970 and is a limited edition style, available only at select US Goyard boutiques: New York, San Francisco, Bal Harbour Shops, Neiman Marcus Chicago, and Neiman Marcus Beverly Hills. 1 / 8 2 / 8 3 / 8 4 / 8 5 / 8 6 / 8 7 / 8 8 / 8  

0 0 Why Stack Overflow's Documentation effort failed -- a few thoughts from a technical writer's perspective 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 Plan a Trip to Carson Valley, Nevada but considering sometimes it could take that long just to drive to San Francisco, why not escape the palm trees of Southern California for a weekend and experience something totally different? I'm admittedly not the most avid outdoor adventurer, but the beauty of Carson Valley definitely has...  

0 0 When the pain of ignorance exceeds the pain of learningUsers turn to documentation when the pain of their ignorance exceeds the pain of learning. Unfortunately, this is the worst state of mind to try to learn anything in. To address this impatient state of mind, we need to write documentation in simpler, easier to digest ways. Task-based...  

0 0 Introducing Senreve Handbags PurseBlog Though based in San Francisco, Senreve bags are handcrafted in Italy by Tuscan artisans with 100% Italian leather. Senreve artisans have worked with top luxury brands for more than a combined fifty years, and it shows: the bags are incredibly well-made, the leather is sturdy yet supple and...  

0 0 Write the Docs Podcast Episode #7: Let The Robots Do The WorkIn this podcast, we first explore the flourishing community of technical writers in Poland, discussing why the tech writing scene in Krakow is taking off so quickly and what trends this young tech writing community is embracing. We're joined by special guest Pawel Kowaluk, a Polish tech writer...  

0 0 Circle review -- How to manage your kids' access to Internet devicesWith four kids and a house full of devices, it can be pretty hard to wrangle devices from kids' hands and shut off Internet time. In the past, I tried putting all the kids' devices onto a guest network and all my devices onto a main network. When I wanted to shut off the kids' access to the...  

0 0 The problem with FAQs in documentationMany tech writers have a heavy disdain for FAQs. At first this disdain seemed a bit unfounded and elitist to me, but now, after a recent project, I'm starting to understand the reasons for the disdain. All too often the FAQ format is abused by non-writers who want an easy way to write. The...  

0 0 My second-chance points strategy with documentationIn addition to being a technical writer, I also play basketball. I might spend more time playing basketball, in fact, than I do writing on this blog. I never played college ball, but I love playing pickup basketball several times a week at various courts. Now that NBA season recently finished,...  

0 0 Write the Docs Podcast Episode #6: Metadata and UI copyIn episode 6, we explore the role of metadata in documentation and how it can be used to classify topics and assist in the discoverability of information. We're joined by special guest Eva Jackolis who explains a strategy for metadata used in German mechanical engineering documentation. We...  

0 0 Recording of my WTD Portland 2017 presentation on Building navigation for your doc site -- 5 best practicesHere's the recording of the presentation I gave at the Write the Docs 2017 Portland conference. The presentation explores best practices for doc navigation, including principles such as hierarchy, modularity, progressive disclosure, entry point, and wayfinding. The presentation is about 20...  

0 0 Limits to the idea of treating docs as codeIf there's been a theme for the past year in tech comm, it's to treat docs like code. Most people get behind this idea with a great amount of enthusiasm. And yet, in many ways, docs are not entirely like code. You can make processes a lot more complicated if you push the the docs-as-code idea...  

0 0 How big should your documentation repo be?How big should your documentation repo be, especially if you have multiple products in your documentation? Although you could put all content into the same repo, it might be easier to have lots of little repos. Jekyll accommodates this architecture quite nicely through gem-based themes. When I...  

0 0 What We're Wearing: San Francisco Where do you go? There is so much to see and drink and eat in this wonderful town! Even though I was born & raised in San Francisco, I'm still partial to the classic city adventures. I love taking the cable car from Powell street to the Hyde Street Pier and then grabbing an Irish Coffee at...  

0 0 Yordano Ventura Commemorative Custom Cleats for Gregory Polanco Ventura's lights out effort over 7 innings against the San Francisco Giants kept the Royals alive for a game 7 match up. We've yet to hear word if Polanco will grace the field with these. But the bar has definitely been set for custom cleats in the MLB whether these make a game appearance...  

0 0 Slides for Write the Docs Portland presentation on doc navigation best practicesSlides for my presentation on doc navigation are available below. I'm giving this presentation at Write the Docs Portland on May 15. The presentation is about 20 minutes long. Although users typically arrive at doc websites in a confused and impatient state, not sure of where to find what...  

0 0 Testing your documentation -- updates in API doc courseTesting your documentation is such an important part of tech writing that I decided to expand the sections on testing docs in my API doc course. I actually grouped these pages into their own section, amplifying the content with more detail and better organization. Here are the pages on testing...  

0 0 My Calm Meditation app -- another experiment to test my docsI recently created an HTML5 web app called Calm Meditation. If you have a Fire TV, you can check out the app by searching for it in the Amazon Appstore. I'm not really into meditation, but I needed some sample video content to test out a web app framework I'm documenting. The idea I came up...  

0 0 Write the Docs Podcast Episode 5 -- Where do we belong?In this episode of the Write the Docs podcast, we explore where technical writers belong in an organization. Is tech comm best placed within engineering, marketing, product management, or another group? We also talk about strategies for doc navigation, in particular, the merits of inline links...  

1 2 3 4 5 6 7 8 9