How to create a help API

Innovation in tech comm 1.0 Sustaining and disruptive innovations 1.1 A long list of technical innovations semi-relevant to technical writers 1.2 The only significant innovation for tech comm 1.3 XML and the web: d...

Static site generators start to replace web publishing platforms like WordPress

Innovation in tech comm 1.0 Sustaining and disruptive innovations 1.1 A long list of technical innovations semi-relevant to technical writers 1.2 The only significant innovation for tech comm 1.3 XML and the web: d...

Some web tools worth using in help solutions

Innovation in tech comm 1.0 Sustaining and disruptive innovations 1.1 A long list of technical innovations semi-relevant to technical writers 1.2 The only significant innovation for tech comm 1.3 XML and the web: d...

Piggybacking onto the innovation of the web

Innovation in tech comm 1.0 Sustaining and disruptive innovations 1.1 A long list of technical innovations semi-relevant to technical writers 1.2 The only significant innovation for tech comm 1.3 XML and the web: d...

Microsoft and the last 5 great technological innovations

Innovation in tech comm 1.0 Sustaining and disruptive innovations 1.1 A long list of technical innovations semi-relevant to technical writers 1.2 The only significant innovation for tech comm 1.3 XML and the web: d...

Interactive video workshop in San Jose this Saturday, 1-5pm

If you're in the San Francisco Bay area and are interested in learning more about creating interactive video tutorials, check out the Best Practices when Creating Interactive Video Tutorials Workshop, sponsored by the STC-Silicon Valley chapter. The workshop will be held at the West Valley Branch Library, 1243 San Tomas Aquino Rd., San José, CA 95117 on Saturday, February 21, from 1pm to 5pm. The event is open to everyone, and the cost is...

The genius of Github and how it can transform tech comm

Innovation in tech comm 1.0 Sustaining and disruptive innovations 1.1 A long list of technical innovations semi-relevant to technical writers 1.2 The only significant innovation for tech comm 1.3 XML and the web: d...

XML and the web: drifting farther apart?

Innovation in tech comm 1.0 Sustaining and disruptive innovations 1.1 A long list of technical innovations semi-relevant to technical writers 1.2 The only significant innovation for tech comm 1.3 → XML and the web: drifting far...

The only significant innovation for tech comm

Innovation in tech comm 1.0 Sustaining and disruptive innovations 1.1 A long list of technical innovations semi-relevant to technical writers 1.2 → The only significant innovation for tech comm 1.3 XML and the web: drifting farther apar...

A long list of technical innovations semi-relevant to technical writers

Innovation in tech comm 1.0 Sustaining and disruptive innovations 1.1 → A long list of technical innovations semi-relevant to technical writers 1.2 The only significant innovation for tech comm 1.3 XML and the web: drifting farther apar...

Sustaining and disruptive innovations

Innovation in tech comm 1.0 → Sustaining and disruptive innovations 1.1 A long list of technical innovations semi-relevant to technical writers 1.2 The only significant innovation for tech comm 1.3 XML and the web: drifting farther apar...

Podcast: The upcoming tcworld India conference on March 12-13, with Akash Dubey

Listen here: This weekend I talked with Akash Dubey, one of the main organizers of the tcworld India conference, about the upcoming conference in India. Although I haven't mentioned it on my blog yet, this year I'm actually attending tcworld India as an invited keynote presenter. tcworld India is a joint effort by two groups: Technical Writers of India (commonly known as TWIN) and tekom (the same group that creates the ...

Why do we need PDFs?

I've never been a fan of PDFs, but PDF output is usually a requirement someone invariably brings up for documentation. In some cases, often for unstated reasons, users will ask for a PDF, and product managers expect technical writers to deliver one. When I get these requests, I usually create a zip file of the website and send it to the user, instructing the user to click the index file to launch it. This works well for these two situatio...

Upcoming workshop: Creating Interactive Video Tutorials, with Bernard Aschwanden on Feb 21

If you're in the San Francisco Bay area and are interested in learning how to create interactive video tutorials, we have a workshop just for you. The STC Silicon Valley chapter is hosting a workshop titled Best Practices when Creating Interactive Video Tutorials. The workshop is led by Bernard Aschwanden -- a consultant at Publishing Smarter and the Vice President of the general STC. The workshop will take place on Saturday, Feb. 21, fr...

Best practices for API documentation -- podcast with Andrya Feinberg

I recently talked with Andrya Feinberg, a documentation manager and content strategist for Emotient, about best practices with API documentation. Below is a writeup Andrya has provided that summarizes some of the points she makes in the podcast. Listen here: Here is Andrya's summary of the best practices: API Documentation Best Practices, by Andrya Feinberg In the world of Technical Communication, Content Strategy, Use...