Complex tools versus simple tools

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

Upcoming webinar: Creating code samples for API/SDK documentation

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

DITA: Nested subheadings and the concept element

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

DITA: Limitations with the chunk="to-content" attribute in relationship tables

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

DITA hierarchical links, related links, short descriptions, and one-folder organization

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

DITA: Why DITA, metadata, working in code and author views, and relationship tables

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

DITA: Folder hierarchy, conref, mapref, and more

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 begins

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

The need for robust tech comm authoring tools

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

Strategies for using links with DITA

One of the strategies that always seems to cause me dilemmas with DITA is how to best handle linking. Mark Baker has an in-depth essay on linking, where he explores many of the issues associated with links. I would point you to the post, but whether to insert the link here or elsewhere is at the heart of many discussions about linking. So I'll briefly delay inserting the link while exploring the risks of doing so. If I insert the link to ...

STC Chapter provides lavish "all expenses paid" outing to San Diego zoo for members

Note: This was an April Fool's Day post. The West Bay STC chapter recently provided a special expedition to the San Diego zoo for all chapter members who wanted to participate. 67 members signed up for the special zoo tour, which involved several exclusive behind-the-scenes encounters with animals, including but not limited to the famous China panda, Xena the giraffe, and a habitat for Capuchin monkeys. The chapter president, Mark Zimmer...

Now that debts are paid off, plan to travel the world for a year, documenting things

Note: This was an April Fool's Day post. It's official. Starting May 1, 2014 until May 1, 2015, my wife and I are taking the year off to see the world. By see the world, I mean we will travel from country to country (from the U.S. to Europe, Africa, Asia, China, Alaska, and the Polynesian islands -- as we make our way around the earth). The idea for the trip came about in part because we finally paid off all our debts -- student loans, ca...

Dita Von Teese to give keynote at DITA North America 2014 Conference

Note: This was an April Fool's Day post. Dita Von Teese will be giving the keynote to DITA North America, The Center for Information-Development Management (CIDM) recently announced. DITA experts and other attendees are thrilled as they look forward to her keynote. "I kind of always wanted to see her at the conference," said Don Day, father of DITA. "It's just a natural fit." While some were surprised at the selection of a burlesque dance...

New hot coals event to be highlight at Lavacon conference

Note: This was an April Fool's Day post. Long-time participants of Jack Molisani's Lavacon Conference know the conference's location originated in Hawaii at a time when tech writer budgets allowed for travel and vacationing in the islands. In an effort to better brand Lavacon and make it more unique -- especially in light of the competing Information Development World conference taking place during the same month -- Jack has announced tha...

The Content Wrangler Announces New 52 Mini-Conference Model

Note: This was an April Fool's Day post. Scott Abel of The Content Wrangler has already either planned or executed three profitable conferences this year -- Intelligent Content, Intelligent Content Health Sciences, and Information Development World. Scott recently announced a new micro-conference model, patterned after his Language of Content Strategy book, that will include 52 conferences scheduled for 2015. The 52 new conferences added ...