san francisco

0 0 How big should your documentation repo be?From 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 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...  

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

1 2 3 4 5 6 7 8 9