Category Archives: bits n bobs

Content management LOL

Ready for a Friday chuckle?

I took this picture in a stairwell, then tweeted it:

This has to be an important document! 

Content management LOL

Content management LOL

Here’s the reply I received from Alan J. Porter:

I think that may be taking content management a little too far!!

While Michael O’Neill quips:

Can’t tell if it’s a usability fail or win. ;P

LOL (laugh out loud)! :)

Playing with Checkvist for handy online “to do” lists

A few weeks ago Sasha dropped a comment on my blog about a website called Checkvist. She called it an “online outliner”, a pet project developed by herself and her husband. That sounds pretty cool, I thought.

So I moseyed over to Checkvist and found that it’s a place where you can create neat “to do” lists quickly. Then you can do all sorts of things with them.

The power of the list

Are you a list person? I am. Never underestimate the power of the list in keeping the scary chaos of the multiplex universe at bay. ;) Checkvist is particularly awesome because you can create hierarchical lists – one list item can be the child of another. Take that, oh chaotic universiplex!

On a side note, people even use Checkvist to plot the outlines of their novels.

What does Checkvist look like?

Here’s a list on Checkvist :

Playing with Checkvist for handy online "to do" lists

Playing with Checkvist for handy online "to do" lists

The format is nice and clean. You can change the “view options” to display your list as a numbered list or to show details such as date last edited and by whom.

How does Checkvist behave?

I love it! The interface is very no fuss no bother. Just click, something happens, it’s what you wanted and you’re done. The power is in the shortcut keys. Look out chaotic universiplex, here we come.

Cutting loose from the Checkvist website

You don’t have to visit the Checkvist website for every interaction with Checkvist. There are a number of options for more flexible interaction.

Do you live in your web browser? You can put Checkvist into a Firefox side panel or a Chrome popup. Here’s the Firefox side panel (with Wikipedia in the main panel):

Playing with Checkvist for handy online "to do" lists

Playing with Checkvist for handy online "to do" lists

There’s a Google gadget that you can put on your iGoogle home page. I wonder how many people use iGoogle as their home page and how many people use gadgets regularly. Do you? I experimented with iGoogle a while ago, but don’t go there regularly any more.

Checkvist supplies a bookmarklet that you can drag onto your browser. First make sure your browser is showing the bookmark toolbar. Then go to your user profile in Checkvist, click “Tools and Extensions” and drag the bookmarklet to the browser’s bookmark toolbar. When you are on a web page and want to remind yourself about something associated with that page, just click the bookmarklet to add a linked item in your Checkvist list.

There’s a mobile interface for use on the iPhone and other smart phones.

Checkvist integration with Confluence wiki

In her comment, Sasha pointed out that you can convert a Checkvist list to Confluence wiki format. True to Checkvist style, it’s very simple. Just click “export” and choose Confluence wiki format.

Playing with Checkvist for handy online "to do" lists

Playing with Checkvist for handy online "to do" lists

The output appears in a new browser tab, so that you can copy and paste it into Confluence. It contains the wiki markup that Confluence will recognise.

Playing with Checkvist for handy online "to do" lists

Playing with Checkvist for handy online "to do" lists

There are other export formats too, including OPML.

Checkvist integration with JIRA issue tracker and Gmail

This is very handy indeed. The Checkvist bookmarklet, mentioned above, has a special relationship with three web applications:

I tried it in the first two. Go to Gmail and open an email message. Click the Checkvist bookmarklet. Checkvist pops up a dialogue offering you the option to add the email message as a task.

Open an issue in JIRA and click the bookmarklet to add the issue as a Checkvist task. Magic. That’s how I created the first item in my Checkvist list. CONF-5994 is a JIRA task:

Playing with Checkvist for handy online "to do" lists

Playing with Checkvist for handy online "to do" lists

Why would I want a simple, online “to do” list?

I have JIRA for project management and issue tracking. I have Outlook tasks. I have Gmail. I have Confluence wiki for collaboration. Why add Checkvist to the mix?

Well, at the moment I use Outlook tasks for micro management. JIRA is great for the big picture, but sometimes I need a short list of things to kick off the day. Things I know I will and must look at first thing. Outlook tasks are very good for this. But there are two drawbacks:

  • This is the only thing I use Outlook for. It’s a bit of overkill to run Outlook just for micro task management.
  • I can only access the tasks from my desktop PC. So if I know I’ll be working from home or some other remote location, I email myself all the urgent tasks coming up. If my working remote is unplanned, I just have to guess what they are. :)

Sometimes I’m busy with an urgent issue in JIRA bug tracker, and I want to send myself an extra special reminder, just for me. I could just click the bookmarklet to add the issue as a task in Checkvist.

Maybe I want to make sure I reply to my mother’s email message, and I’m afraid it will disappear into the morass that is my email inbox. No worries, just click the Checkvist bookmarklet.

Lots of other uses I haven’t tried yet

There’s the guy who outlined his novel on Checkvist. You can share a list and work with other people to compile the tasks – maybe a list of holiday “to dos”. It could be a handy tool for a brainstorming session, especially if the scribe is a wizard with the Checkvist shortcuts.

tl;dr: I think Checkvist is pretty cool. Let me know if you’ve tried it too.

Collective noun for a group of technical writers

This week a colleague, Tom, came up to me with a big grin and asked, “What’s the collective noun for a group of technical writers?”

He had another developer in tow, a new starter at that, and the grin made me wonder what mischief lay behind the question. ;) But it’s a goody and it made me laugh. I came up with “a scribble of technical writers“. Later, it occurred to me that we could call a group of agile technical writers a “jot“.

Can you think of any good names for us and for what happens when we get together in a group?

Yard table assemblage instructions

These “Yard table assemblage instructions” were included with a garden table we bought. :) Actually, the structure of the guide is good. There’s a list of parts and then the “how to”. It’s just the language that needs a bit of tender loving care. I love the way it degenerates towards the end, as if the poor author just gave up because it was too hard.

Assemblage parts:

1.One piece of iron flower pattern glass (in midst have a hole).

2.Four table feet.

3.Two fixed stators.

4.Eight screws.

5.Eight screw caps.

Assemblage method:

1.Use the screws and screw caps screw down the table feet and fixed stators.

2.Table top is upward.

3.half-round plastics of under the table top direct against the table feet, Then press it down.

We did manage to assemble the table with no trouble.

Hello, is that you?

Today I walked past two women just as they saw each other on a street corner. This is the snippet of conversation I overheard:

A: Hello!
B: Hello, is that you?
A: Yes.

They both thought this was a perfectly sensible exchange, but I had to chuckle as I went out of earshot.

Why can’t our documentation be as directly and succinctly understood? Because we don’t know the subtext for every passerby who comes across one of our pages.

The title of this blog post has a double meaning, because I am writing it from my iPhone while sitting on the bus. Yes, it’s me.


Get every new post delivered to your Inbox.

Join 1,391 other followers

%d bloggers like this: