Technically Speaking

Another news video of my brother preparing to meet President Bush:
Read the rest of this entry »

Here is a video about my brother, who is going to meet President Bush tomorrow to receive an award:

And here is the text of the accompanying news story:
SALT LAKE CITY - President George W. Bush will travel to Utah on Wednesday, where he will present an award to a local man, who serves as a volunteer to help others.

President Bush will present the award personally to 24-year-old Rick Pehrson, whose outstanding volunteer service led his co-workers to nominate him for the honor — called the President’s Volunteer Service Award.

“It’s kind of intimidating to get calls from the White House,” Pehrson said. “I will be scared enough, I won’t say a lot.”

Rick’s superior at the Utah Commission of Volunteers nominated him for the award, saying that the decision to do so was simple.

“It was easy because Rick is an outstanding individual,” said Kathy Smith, Rick’s boss.

Rick first started volunteering because his family needed him. His father was chronically ill and passed away two years ago. As it turns out, he left behind a son who learned to give to others.

President Bush will present the award to Pehrson on Wednesday, during a trip to Salt Lake City — where the commander-in chief will help raise money for GOP presidential nominee John McCain.

Today I’m pleased to announce a parting of the ways. The blog you’ve known as “Technically Speaking” is splitting its two personalities into two separate blogs.

When I first started this blog in June 2004, I was a college student majoring in technical communication. Most of my traffic came from my parents, my in-laws, my siblings, and a few cousins. I blogged about my family, and about technical communication. It was for fun, and I felt I could say whatever I wanted, because the only people listening were people who I trusted and liked.

Fast forward three and a half years. Yesterday I had 242 visitors on this here blog. In the last month, I’ve had almost 5,000 visitors. In 2007, I had more than 65,000 unique visitors make over 141,000 visits (with a total of 1.2 million hits). Most of these hits come from Google search results; the readers find an old post, and then they leave. I’ve become something of a repository of knowledge for various topics, which is nice. But this is no longer a quiet conversation between family members.

As my visitor count increased, my desire to keep certain information off my blog increased. I don’t think this is a good location to discuss the birth of our second child (which occurred last month). This doesn’t seem to be the correct venue anymore to discuss my “better living by doing it yourself” experiences. It certainly isn’t a place where I feel like I can post pictures of my family or talk about parenting kinds of things. However, I like doing these things, and I wanted a venue where I felt like I could do that. Thus the parting of the ways.

This blog, Technically Speaking, will continue to be where I blog about technology, technical communication trends and tools, grammar, and other related topics. If you are interested in my thoughts on software, Web 2.0 trends, or MadCap Flare, this is the place to read.

I’ve also created a new blog, pehrsonfamily.net, a personal blog that meets the needs discussed above. This blog is password protected; you won’t be able to see the blog unless you log in. This keeps Google and other search engines out, and maintains a certain level of privacy. (I know my images won’t be indexed on any image indexing service. I know people won’t find my content by searching through a search engine. They will only be reading if they’ve gone through the trouble of creating a user account; i.e: they are real people.)

When you get to the main page, click on the Register link. You will need to provide a username and an e-mail address. Your password will be e-mailed to you. The first time you visit the site, you will be see your profile page. Change your profile and set your preferences. On subsequent logins, you’ll be directed to the new posts page, rather than your profile page.

If you have any questions about this change, feel free to contact me. Thanks for reading. I hope you enjoy whichever version you choose. (Feel free to read both!)

My friend Tom Johnson posted an article (new window) last week about the recent release of the Technical Communication Suite from Adobe including RoboHelp 7. I added a comment to his post, but it got kind of long, so I thought I’d post it here with slight modifications. The quotes in this post are quotes from Tom’s post, linked above.

I’ve taken a look at RH7, and I personally wasn’t all that impressed with it. As I’ve watched discussions on RH7 evolve for the last few months, my experience is that people who want to be wowed by RH7 are wowed by it. People who want to be pleasantly neutral are able to be pleasantly neutral. And people who want to hate RH7 find plenty to hate about it. Tom said:

This past month I’ve been heavily using the RoboHelp 7 and Captivate 3 components of the Technical Communication Suite. RoboHelp 7 offers some impressive new features: snippets, breadcrumbs, a pod-based interface that you can drag around, integration with Framemaker and Captivate, and so on.

So basically RH has come out with some of the stuff Flare did, and copied the terminology (”snippets” for example) just to compete. Not particularly innovative, in my opinion, especially when they are a couple of years late to the party.

RoboHelp 7 allows you to begin Captivate movies from within RoboHelp. That way you don’t have to keep re-importing the files each time you update them. […] I ended up deleting the RoboHelp-initiated movies and imported them manually instead (File > Import).

My response is: then how is this good? If you ended up importing them separately, then don’t you have to keep updating them?

Personally, I prefer the way Mimic works for referencing the Mimic project from Flare, then building the Mimic output when Flare is built. You can share variables across products so your Flare variables are available for use in Mimic. That is pretty cool. While Captivate has more features and is easier to use than Mimic, I think you’ll see Mimic improve as MadCap puts more dev time into it, and it is a project that seems be getting some more attention internally. It will be interesting to see how these compare in a year or two.

Later in Tom’s post:

You might also want to be careful about manually editing the css style sheet. […] I recommend using RoboHelp’s official style editor, and perhaps playing with the _ns.css stylesheet that RoboHelp outputs when you generate help.

I hate anything that requires post-processing. A tool that requires post processing for creating WebHelp is broken, in my opinion. I want to be able to build my target and publish it in the next step. (However, I give more allowance for printed output, because there are conventions in printed output that are currently hard to get from the available tools.)

Online Help Quality Plummets

It’s a bitter irony when a HAT vendor produces poor quality help for its products.

Tom then turns attention to importing Frame files into RH7:

Framemaker Import Groundbreaking But Irrelevant for Me
[…]
Flare is developed by a team that is experienced with help authoring, and—perhaps the most confusing distinction—Flare seems to support FrameMaker more thoroughly both for importing and exporting content than does RoboHelp.

It’s ironic isn’t it? MadCap’s product does better with Adobe’s own FrameMaker than Adobe is. But I don’t get how this is groundbreaking? I mean, Flare does this and does it better. In Flare you can round-trip your FM files. THAT is groundbreaking and innovative.

I believe this is indicative of a larger problem within Adobe: they purchase a product then get rid of the developers who understand the product. Adobe is having trouble updating and making Frame compatible with other Adobe products because it seems they don’t understand the code behind what it does. I also wonder if they really understand the RoboHelp code enough to update it to compete in the new space (now that it has to compete with Flare, AuthorIT, and others).

It will be very telling to see what happens in the next RoboHelp release. Frame 8 is bascially Frame 7.2 with a new UI and a couple of upgraded features. But there isn’t any competition out there pushing Adobe to make a better Frame. RoboHelp is now in catch-up mode trying to figure out how to emulate the innovative features in MadCap’s product suite. Now it is MadCap pushing the innovation envelope here. Will RH be able to maintain pace with MadCap’s one (or more) releases per year? Will RH be able to come out with new features that aren’t already in Flare? Maybe so, but RH 7 wasn’t proof of that yet. Again, it will be interesting to have this discussion in two years and see where the major players are at.

In Tom’s conclusion he states:

RoboHelp continues to ignore some major issues, such as the lack of character-level indexing and the formatting errors when you export to Word. Despite my complaints, I like many others have an affinity for the usability of this tool. It’s like an old pair of sneakers that has some new laces and polish. Maybe some new traction too.

With his conclusion, he supports my theory that those who wanted to like it do like it. Despite all the problems Tom enumerated in his post, he still have a favorable impression of RH–a tool he has used in the past with good results. I tested RH7, and I’m very glad my primary HAT is Flare.

But to each their own. If anything, I hope a healthy competition between Flare and RH continues because that will help both products improve. Frame is a great example of how a product can go stagnant when no outside competition drives the need for new changes and features.

The Utah State Capitol building has been closed for more than three years for a renovation project. The building has received a seismic upgrade in addition to being restored to the original architect’s vision and specifications. On the anniversary of Utah’s statehood, January 4, 2008, the Capitol will be re-opening and will be re-dedicated.

The Lt. Govenor’s office in conjunction with the Capitol Preservation Board is holding a week-long open house and celebration. To accommodate the thousands of expected guests, the state of Utah is seeking volunteers to assist in the event. Volunteers are needed for four-hour shifts during the week of Jan 4 through 12. If you can donate four hours of your time to the people of Utah during that week, I invite you to join me in volunteering.

More information is available at the volunteer registration website.

I hope to see you there.