How to create a help API

tooltipdemothumb

In my last post in this series, I talked about static site generators as a platform for help. In this post, I want to explore Help APIs, which is actually something in part enabled by static site generators. To put things in context, the web is sort of a giant API. Each browser functions as Continue Reading »

Some web tools worth using in help solutions

In the previous post in this series, I argued that piggybacking onto the innovation of the web requires us to use the same web platforms that web developers create, support, and maintain. In this post, I want to mention a few web technologies worth checking out. jQuery jQuery is a JavaScript library that provides functionality Continue Reading »

Piggybacking onto the innovation of the web

In the previous post in this series, I looked at the five major technological innovations of the past decade and asked how tech comm plugs into each of them. In this post, I want to explore ways to piggyback onto the innovation of the web. Challenges in hacking A few months back, I was exploring Continue Reading »

Microsoft and the last 5 great technological innovations

microsoft

I recently came across an interesting article by Jason Calicanis called Microsoft is interesting again — very. It talks about why Microsoft has lost out on the last 5 major technical innovations, and how they are poised to make a comeback. Calicanis writes: Microsoft has been largely dead to Silicon Valley because for the past Continue Reading »

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 Continue Reading »

The genius of Github and how it can transform tech comm

forked

This is post #5 in my ongoing series on innovation in tech comm. In the previous post, I argued that many web developers and designers seem less savvy and eager to use XML in the platforms they develop, preferring instead to focus on HTML5, CSS, JavaScript, and JSON. In this post, I explore Github and Continue Reading »

XML and the web: drifting farther apart?

In my previous post in this series, I explored how the web empowers everyday people as technical writers. I’ll return to this idea in a major way, but first I want to note some other trends that will plug in to this ongoing discussion on innovation. In this post, I want to dig a bit Continue Reading »

The only significant innovation for tech comm

When I surfaced the topic of innovation on my blog (in the first post in this series), some people noted that the only really noteworthy innovation to affect technical communication in the past 20 years is the web. Mark Baker, author of Every Page Is Page One, made one of the most insightful comments. He Continue Reading »