san francisco

0 0 Write the Docs Podcast Episode #6: Metadata and UI copyAmazon'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 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...  

0 0 Loving This Week: An All-Day Heel + A Valet Key Ring Valet parking is a necessity of life in San Francisco. This key ring makes the task of leaving only the car keys with the valet easy, without sacrificing style. I'm leaning towards giving up my oh-so-practical carabiner for this designer upgrade. I had no idea my favorite new scent is...  

0 0 Following instructions involves learning a new language -- adventures with Tinker Crate projectsIn following instructions to assemble a Tinker Crate project over the weekend, I realized that list of parts (essential for assembly kits involving physical objects) is similar to a glossary, in that it teaches you a new vocabulary. Software projects also involve new vocabulary terms, but...  

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

1 2 3 4 5 6 7 8 9