san francisco

0 0 Madcap Central -- a first look at Madcap's new cloud-based collaboration and publishing solutionAlthough email may seem somewhat antiquated, it has by far the greatest reach of any online communication method. If you have a Jekyll-based site, here's an easy approach to sending out an email newsletter. This approach involves using a for loop to get a summary of your latest posts and then...  

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

0 0 How much code do you need to know to create API developer documentation?With developer documentation roles, some level of coding is required. But you don't need to know as much as developers, and acquiring that deep technical knowledge will usually cost you expertise in other areas. Get new posts delivered straight to your inbox. Powered by ZipRecruiter I'm a...  

0 0 Attend my upcoming TC Dojo presentation on Swagger on Jan 9, 2017I'm giving a TC Dojo presentation this Monday morning (Jan 9) on Swagger. If you're interested, you can register and attend for free. The event will also be recorded. In the spirit of a dojo, my presentation is called Harnessing the Chi of Swagger in Your API Docs. Here's the description:...  

0 0 TC Camp in Santa Clara to be held Jan 21, 2017TC Camp is holding its annual free unconference for Tech Comm on Jan. 21 in Santa Clara. TC Camp starts with morning workshops given by experts in the field for a nominal fee. The unconference follows, where attendees vote on the topics to be discussed. It's a great event for networking and...  

0 0 CHAPTER 10. THE LEGACY he like a president and she like a first lady, they lived in san francisco before relocating in the 80's to an urban suburb of west pittsburg, about 45 minutes outside of the city. this is where we grew up. gramma and grampa took care of all 14 grandchildren, collectively and individually in...  

0 0 Write the Docs Podcast Episode 2 (which Focuses on Findability) Now AvailableEpisode 2 in the Write the Docs podcast is now available. The topic of episode 2 is findability: How do you allow your users to find what they're looking for in your documentation? We talk about various tools for findability: search, tags, faceted filters, sidebar navigation, inline links,...  

0 0 Generalist versus specialist: What should you focus on with knowledge building in your tech writing role?I've been thinking about how I should focus my time with knowledge building in my tech writing career, especially given my context in a large organization. Lately, rather than primarily writing content, I've been playing more of a content curator / tools developer / publisher role. I'm okay...  

0 0 Updating a single page versus updating the documentation as a wholeThis past week I made some contributions to the Jekyll documentation, and in making the pull requests, I realized why technical writing is often so difficult. Making a request to one documentation topic often requires you to adjust other topics as well. So often we place the bar for...  

0 0 10 Things You Need to Know About Goyard's Iconic Handbag History 5 / 10 Until 2015, the only standalone Goyard boutique in America was in San Francisco. There's now one in New York, but with those two and a couple of store-in-store boutiques at Bergdorf Goodman and Barneys, there are fewer than half a dozen places to buy Goyard in person in the United...  

0 0 Things I Bought That I Love: Uniqlo HEATTECH Camisole I bought my first two HEATTECH camis when I visited London in 2008, then two more in New York in 2010, and another two in San Francisco a couple years ago. For less than $20 a pop, they really are the bee's knees because: The next time I'm tempted by the siren's call of a brand new...  

0 0 New podcast from the Write the Docs communityThe Write the Docs community now has a podcast available. The podcast follows a discussion-based format with several co-hosts talking about recent articles or topics related to tech comm. The podcast is available on almost every podcast platform. You can view the new Write the Docs podcast...  

0 0 Review of Coding for Writers course by Peter Gruenbaum on UdemyPeter Gruenbaum has a new course on Udemy called Coding for Writers. Overall, this course takes a unique angle in not only teaching you the basics of coding (in this case, mostly JavaScript and Java), but also teaching you how to document the code, such as focusing on parameters, responses,...  

0 0 Recording of Open Authoring -- Collaboration Across Disciplines presentation, by Ralph SquillaceRalph Squillace, a senior content engineer for the Microsoft Azure Infrastructure team based in San Francisco, California, recently gave a presentation to the STC Silicon Valley chapter (on November 14, 2016) on Open Authoring -- Collaboration Across Disciplines. In the presentation, Ralph...  

0 0 The Ultimate Bag Guide: The Goyard St. Louis Tote and Goyard Anjou Tote Personalization services are all hand-painted in one of three workshops (San Francisco, Tokyo or Carcassone, France), which means they take at least 3 to 4 weeks for completion. With either black or tan leather trim All St. Louis Totes are made out of Goyardine, which is a colored textile...  

0 0 How to avoid becoming extinct in your technical writing career 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 Should you ever apologize for something product-related in your documentation? Looking at Apple's dongle documentationApple's recent dongle fiasco raises an interesting tech comm question: Is there ever a time when you, as a technical writer, should apologize for something product-related in your documentation? I looked at Apple's end-user docs about their ports but didn't see any acknowledgement that they...  

0 0 The 10 Best Bag Deals for the Weekend of November 4 I'm coming to you on this fine November day from San Francisco, where it is much earlier than my usual perch in New York. I've been here since Saturday and I have no concept of what time it is anywhere, though, so I'd believe just about anything you told me. What's even better is that I'm...  

0 0 How to get crisp text callouts like in Apple's new Touch bar documentation -- and why you might not want toApple's new Macbook laptops include a Touch Bar that replaces the function keys at the top of the keyboard. You can program these keys with your own custom functions. I was curious to see what the documentation for the Touch Bar looked like. In looking at the Apple docs, the most interesting...  

0 0 How to deliver newsletters for your Jekyll siteAlthough email may seem somewhat antiquated, it has by far the greatest reach of any online communication method. If you have a Jekyll-based site, here's an easy approach to sending out an email newsletter. This approach involves using a for loop to get a summary of your latest posts and then...  

1 2 3 4 5 6 7 8 9