Category Archives: Ottawa

No, that’s not a job

I created a new position on LinkedIn: “Rodeo Manager at Rob’s Search Kit”.

No, “Rob’s Search Kit” is not a company that hired me. It was a “funny” name for searching for a job. I have renamed that fake company to “Rob’s Job Search”.

Sorry for being unclear. Several people congratulated me on my “new job”. I hope the name change will help.

Continue reading

Angular 2 released

Google has announced that Angular 2 is ready for real world use!

If you need a Javascript library for developing a Single Page App, Angular 2 is a good way to go. Apparently lots of people have been using it, even in the pre-release beta versions.

As I learn more about modern Javascript, I am also learning about Javascript frameworks that provide Dependency Injection capabilities, of which Angular is one of the most used. I am reading and working with Reliable Javascript – How to Code Safely in the World’s Most Dangerous Language by Lawrence Spencer and Seth Richards.


I like their tag line on the blog title: proprioception-reinforcement.

What does it mean?

Discussing first the word I understand: reinforcement means making the original better or stronger – That’s a nice way to describe version 2.

That other word? Proprioception – that’s a medical term meaning the ability of the body to sense the relationship of one  part with another. An example of that would be the ability to sense when your arm is moving relative to your body – which is an “Angular” movement.

Thanks to Javascript Weekly for letting me know about Angular 2’s release.

Documenting XML in DITA 1.3

We have XML configurations in some Wind River software, so we need to document those XML elements and attributes. When we document our DITA implementation for our writing team, we also mention XML elements and attributes. Here are my thoughts on our transition process, and on XML domains in DITA.

I am looking forward to replacing the DITA 4 Publisher’s XML domain with DITA 1.3’s XML Mention Domain. I think the only difference is that <xmlelem> becomes <xmlelement>. We will have to allow the old element “forever” since it is found in topics in our CMS, including tagged copies of our releases.

We are using Schematron to enforce rules in the oXygen editor, so we will likely use that to ask writers to change instances of <xmlelem> to <xmlelement> when they edit a topic containing the old element.

Also, we mention the names of our doctypes. We consider doctypes to be different from regular XML elements, so <xmlelement> is not suitable. We use (writing from home here – guessing the correct spelling) <doctype-name>.

Does anyone else mention the name of XML Doctypes in your documentation? Do you use <xmlelement>? What do you do instead?



Choosing a version control system for your Tech Pubs department

I assume here that you have already identified a need for a version control system. Choosing one may be your next step.

First choice: Use whatever version control system your developers use.

  • Your department may have to pay for a license on the server software, but you will have advice and assistance readily available.
  • Some of your writers will use it for different tech pubs projects and get proficient at a tool that is crucial to your company’s developers.
  • You may be able to piggyback your server license on theirs.
  • The IT department that set up their server for version control already knows how to do that. When you get your own server, they will already know how to set it up.

Second choice: Git

  • This is one of the most popular open source version control systems.
    Even if your company does not use it, you should be able to find help and advice in your development team. Check that this is true at your company before you make a decision.
  • Like most version control systems, there are GUI tools for Git, so you are not restricted to command line access to your data. On Windows, TortoiseGit is good, easy to use, and free.
  • Several companies provide commercial servers for Git, including Atlassian. Atlassian’s BitBucket server is inexpensive, but full-featured and easy to use and administer.
    There are open source servers for Git.

Other considerations:

  • Pay extra, if necessary, to keep your data in a separate storage area from the developer’s data. This storage area is usually called a repository, which is abbreviated repo.

Editing menus on LXDE

The menus are created from the foo.desktop file for each application.

To find them, you can do a couple of things.

First, using Synaptic package manager, select the package, then click on the “Properites” icon in the toolbar. Use the tab “Installed Files”.

Second, you can use this command line, where the “package-name” needs to be the name of your package. Tab completion works for Bash shell on the name of the package, if you know how it starts.

dpkg -L package-name | grep desktop

I found this out because I needed to change the “EXEC” string in “d2x-rebirth-demo” (the “Descent 2” rewrite) to:

/usr/local/games/d2x-rebirth/d2x-rebirth -hogdir /usr/local/games/d2x-rebirth/data

Proposed Stack Eschange site for DITA

Anders Svensson has created a proposal for a DITA Stack Exhange Site.
It’s at

DITA is an OASIS standard for XML documentation.

User Group Connect has a new URL

“User Group Connect 2013” has a new URL. You can find us at

If you don’t know about UGC, it is an opportunity for User Group’s in Ottawa to get together and for the Ottawa technology community to get together to meet some of the 30 or so User Groups in Ottawa.

On Saturday February 9, from 10am to 4pm, join us in the lounge at Shopify, 126 York St. The entrance is at the back of the building, from the parking lot.

Accessibility problems – Unfortunately, this location is not wheelchair accessible. It has stairs, and the washroom is up a flight of stairs.

Also, you can still reach the User Group Connect site at the old URL.

New Java 1.7 vulnerability

I found this in my email:

I will disable Java plugin in all browsers on my machines at work on Monday. is taking this seriously:

This could be used against Linux, Mac or Android, not just Windows, if anyone cared to try. They would not have access to root without further exploits, although popping up a window that looks like your Updater, or Microsoft’s, would catch some inexperienced Linux users.

Paula duHamel Yellow Horn and her Snow Duck wing

Dr. duHamel Yellow Horn laid this wing on the National War Memorial in Ottawa, Nov. 11, 2012, Remembrance Day Ceremony.
She laid it to honour her father and two uncles and their participation in the Canadian war effort during the Second World War.
Paula’s father was posted to the factory that made the Lancaster bombers.
Her uncles flew Lancaster bombers over Europe. Continue reading

World Usability Day 2012 in Ottawa

(From the CAPCHI newsletter)

CapCHI is proud to present two presentations on Tuesday November 6th, in celebration of World Usability Day 2012 (officially on Thursday November 8th).

Date: Tuesday November 6th, 2012

Time: doors open at 6:00 pm; talk begins at 6:30 pm

Place: TheCodeFactory, 246 Queen St., Ottawa, ON, Canada

1. “Mixed-media Computer Human Interfaces“, presented by Tim Moore, PhD CHFP, Ergosum Ltd.

2. “The Gist of NIST“, presented by Lorraine Chapman, Director of UX Research, Macadamian

Here is the CAPCHI web site: