san francisco

0 0 Perspectives on tech comm from the VP Candidates — Q&A with Pam BrewerTC Camp 2018 is just around the corner (Jan 26-27, 2018). Liz Fraley started the TC Camp unconference out of a growing dissatisfaction with other conferences. She modeled TC Camp after another camp that was low-cost, run by a non-profit, and intended to better the community. TC Camp's...  

0 0 New Simplifying complexity tutorial: Discoverability through metadataPreviously, I explored the use of embedded maps to help guide users through larger processes. But all the maps I showed were linear maps. What about maps for non-linear, complex systems? In the Simplifying Complexity section of my site, I added a new tutorial for navigating through more...  

0 0 Two open-ended surveys to gauge practitioner/academic attitudesIn my 2018 trends post, I mentioned that I plan to give some attention to TC academic/practitioner attitudes, opportunities, and interactions. I have a larger project in mind that involves changing attitudes, which I'll expand on in the future. However, for now I need a baseline starting point...  

0 0 Recording of OpenAPI and Swagger presentation (for STC and WTD San Diego)I recently gave a presentation to the STC San Diego chapter and WTD San Diego group called "Swagger UI and the OpenAPI specification" (February 13, 2018). You can view a recording of the presentation, browse the slides, and listen to the audio here. You can watch two versions of the video. If...  

0 0 Olivela, The Next Generation of Philanthropic Retail, Launches Beauty(SAN FRANCISCO, CA) FEBRUARY 2, 2018. Olivela, the next generation of philanthropic retail, expands into the beauty category with the launch of a curated selection of makeup, fragrance and nail polish from luxury brands including Acqua di Parma, By Terry, Christian Louboutin Beauté, Eve Lom,...  

0 0 Upcoming STC San Francisco presentation: Beyond mere endpoint reference — the overlooked content in API documentation (Feb 21, 2018)Upcoming STC San Francisco presentation: Beyond mere endpoint reference — the overlooked content in API documentation (Feb 21, 2018) I'm giving a presentation to the STC San Francisco chapter called "Beyond mere endpoint reference — the overlooked content in API documentation" on February...  

0 0 Upcoming STC San Diego virtual presentation on Swagger UI and the OpenAPI spec (Feb 13, 2018)I'm giving a virtual presentation to the STC San Diego chapter and WTD San Diego group called "Swagger UI and the OpenAPI specification" on February 13, 2018. You can read the details in either the STC or WTD event pages: Here's the presentation description: OpenAPI is a specification for...  

0 0 Upcoming API workshop in Denver (March 10, 2018)I'm giving a half-day API workshop in Denver on March 10, 2018. Topics in the workshop will include reference API content (endpoints, parameters, requests, etc.), non-reference topics (status and error codes, rate limiting, getting started, sample apps), creating an OpenAPI specification and...  

0 0 Upcoming presentation in Denver: Docs-as-code tools and workflows (March 9, 2018)I'm giving a presentation to the Rocky Mountain STC on "Docs-as-code workflows and tools" on March 9, 2018. The docs-as-code approach is most common in the developer doc space. In this presentation, I'll explore the upsides and downsides of treating documentation as software code, and what...  

0 0 New section on my site: Simplifying complexityIn an earlier post on value arguments for tech comm, I mentioned that in 2018, I plan to explore some innovative ways to simplify complexity so that I can deepen the value I provide to users. To host this content, I created a new section on my site called "Simplifying Complexity." So far I've...  

0 0 Recording of WTD South Bay presentation: Publishing tools for API documentationI recently gave a presentation called "Publishing tools for API documentation" to the Write the Docs South Bay meetup group on January 18, 2018. The location for the meetup was Google's Mountain View campus. Here are the slides: The video is forthcoming ... stay tuned. The description is as...  

0 0 WTD Episode 13: Postman for API development and docs — Interview with Postman FounderIn this episode of the Write the Docs podcast, we chat with Abhinav Asthana (founder and CEO of Postman) to discuss how Postman, a REST client, can be used to create, collaborate, and publish API documentation. If you work with API documentation, you've probably used Postman to make and test...  

0 0 Loving This Week: Comfort Pumps + a Mulberry Silk Dress I'm a big fan of this new San Francisco-based label, which specializes in beautifully designed, affordable pieces, many of which are perfectly work appropriate. This cotton-blend blouse will look equally great with distressed denim and office separates. The world's most perfect carry-on...  

0 0 New STC Intercom article: How to Research What You Need to Learn to Be Successful as a Technical WriterI published an article in the most recent issue of STC's Intercom magazine titled "How to Research What You Need to Learn to Be Successful as a Technical Writer" (Nov/Dec 2017). The article explores the approach I take in "researching" topics at work to gather the information needed for...  

0 0 Upcoming WTD South Bay presentation: Publishing tools for API documentationI'm giving a presentation called "Publishing tools for API documentation" at the Write the Docs South Bay meetup group on January 18, 2018. The location for the meetup is Google's Mountain View campus. For details, see the event description on the WTD San Francisco meetup group: Publishing...  

0 0 What technical writing trends will we see in 2018? 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 Value arguments for docs and tech comm — Part I: IntroductionIn this essay, I explore arguments for the value of documentation and technical writers in an organization. Although metrics usually fall short as a way to measure value, documentation's value can be established in part through usage. Technical writers can also contribute value by enabling...  

0 0 Part III: Determining value through usage (Value arguments for docs and tech comm)Documentation is valuable. It derives this value not from a carefully measured financial ROI, which is impractical to measure, but from the perceived value by the many groups within the company that use the documentation. But even though documentation has value from perceived usage, it might...  

0 0 Part VII: Conclusion (Value arguments for docs and tech comm)It's time to wrap up this essay with some concluding thoughts and takeaways. I also list the references here for more reading. Note: This is part VII in a seven-part essay. Read the previous section, Part VI: Deepening documentation's value by simplifying complexity before starting here. This...  

0 0 Why is TC Camp's unconference format so popular? Interview with Liz Fraley, TC Camp FounderTC Camp 2018 is just around the corner (Jan 26-27, 2018). Liz Fraley started the TC Camp unconference out of a growing dissatisfaction with other conferences. She modeled TC Camp after another camp that was low-cost, run by a non-profit, and intended to better the community. TC Camp's...  

1 2 3 4 5 6 7 8 9