I attended an STC presentation the other week by Andrew Davis (one of the most helpful recruiters in Silicon Valley) on Ageism and Today's Technical Content Developer. Ageism is simply bias against the capabilities of older people in the workplace, and it's pretty rampant in Silicon Valley. Most programmers are twenty somethings who live on Red Bull and free company food, who roll into at work around 10am and leave at around 7pm in the ev...
Listen here: Yesterday I gave a presentation to the soap! conference group on creating code samples. Here's the video recording: (Note that the audio in the link above is crisper than the audio in the video.) Here are the slides: Here's a link to the PowerPoint file: zip file | pptx file. To learn more about soap!, see soapconf.com and sign up for the soap! newsletter. Add a review for the "I'd Rather ...
Videos are great, but sometimes all you want to do is show a brief clip that demonstrates a certain action. For example, take a look at this article on how to make play-dough. Each step has an embedded, looping video that shows the action you need to take. There aren't any player controls on the videos, and the videos only start when you mouse over them. Embedding looping videos is easy to do with with HTML5 video tags. See this post on...
I was pleased to have my article, Gamification and user engagement in e-learning and documentation, included in the Bleeding Edge issue of the April 2014 STC Intercom magazine. Here's a link to the article: If you don't have access to the Intercom, you can read the same article here, since I posted it on my site a few months earlier.
Listen here: A few months ago I gave a presentation to the STC Sacramento chapter on findability of help content. Here's a link to the slides and other material: PowerPoint slides zip file | pptx | slideshare Sample of one-page help Sample long topic Game worksheet Why users can't find answers in help material -- STC Sacrament presentation from Tom Johnson This presentation was similar to other presentati...
My DITA journey 1.0 My DITA journey begins 1.1 DITA: Folder hierarchy, conref, mapref, and more 1.2 DITA: Why DITA, metadata, working in code and author views, and relationship tables 1.3 DITA hierarchical links, r...
My DITA journey 1.0 My DITA journey begins 1.1 DITA: Folder hierarchy, conref, mapref, and more 1.2 DITA: Why DITA, metadata, working in code and author views, and relationship tables 1.3 DITA hierarchical links, r...
May 30 update: Here's the recording of the presentation. I'm giving a webinar on May 29 on the topic of creating code samples. The webinar is sponsored by the soap conference, which is a new conference in Poland that I featured on my blog a few weeks ago. Here are the details of the webinar: Creating code samples for API/SDK documentation Date: May 29, 2014 Time: 8am PST Cost: Free Location: Online (details below) One challenging yet rew...
My DITA journey 1.0 My DITA journey begins 1.1 DITA: Folder hierarchy, conref, mapref, and more 1.2 DITA: Why DITA, metadata, working in code and author views, and relationship tables 1.3 DITA hierarchical links, r...
My DITA journey 1.0 My DITA journey begins 1.1 DITA: Folder hierarchy, conref, mapref, and more 1.2 DITA: Why DITA, metadata, working in code and author views, and relationship tables 1.3 DITA hierarchical links, r...
My DITA journey 1.0 My DITA journey begins 1.1 DITA: Folder hierarchy, conref, mapref, and more 1.2 DITA: Why DITA, metadata, working in code and author views, and relationship tables 1.3 → DITA hierarchical links, related link...
My DITA journey 1.0 My DITA journey begins 1.1 DITA: Folder hierarchy, conref, mapref, and more 1.2 → DITA: Why DITA, metadata, working in code and author views, and relationship tables 1.3 DITA hierarchical links, related links, short ...
My DITA journey 1.0 My DITA journey begins 1.1 → DITA: Folder hierarchy, conref, mapref, and more 1.2 DITA: Why DITA, metadata, working in code and author views, and relationship tables 1.3 DITA hierarchical links, related links, short ...
My DITA journey 1.0 → My DITA journey begins 1.1 DITA: Folder hierarchy, conref, mapref, and more 1.2 DITA: Why DITA, metadata, working in code and author views, and relationship tables 1.3 DITA hierarchical links, related links, short ...
Neal Kaplan recently posted about the search for a perfectly adequate authoring tool, which got me thinking about the tools I use. At the time I joined my current company, I had to change my help authoring tools quite a bit. At my previous company, I used Mediawiki and Madcap Flare. Both tools worked pretty well. At my present company, we publish on Drupal, which is a web-based CMS similar to WordPress but more robust. All the content liv...
