Posted on Nov 15, 2009

Writing a good dent (or tweet) while at a conference

The next Ubuntu Developer Summit will be starting up tomorrow, and although not everyone can attend the event, there are a number of ways to participate remotely.

Among other things, I like to follow the ‘dents (from Identi.ca) and tweets (from Twitter) from the event.  Typically, people will use Identi.ca and Twitter to share snippets about some particular topic that has come up during the conference, but I’ve found that some notices can be more helpful than others.

For example, here’s a fictitious example of what I think is an unhelpful dent/tweet:  “I’m going to attend the virtualization session! #UDS”

I saw a lot notices like this posted during the last developer summit.  Notices like these show that you’re excited (cool), and they can also help other attendees to know your location at the conference (pretty cool), but they don’t actually tell us much of anything (not very cool).  I know that sometimes you just can’t help it . . . you’re at this great event, and just want to share a bit of what is going on with the outside world.  I’m sure that this is not a big deal in the grandiose scheme of things.

With that, though, let’s take a look at some more interesting ways to make use of these social networking tools.

  • Seek feedback from conference participants: “Experimenting with blip.tv for UDS videos: http://is.gd/1Fv5g what do you guys think?“  Notices like these can be used both during and after an event.
  • Share information about a social event that will be going on after conference hours: “I’ve created a sign up page for Monday night @ the firing range. Everyone welcome https://wiki.ubuntu.com/UDS-L/FiringRangeNight # !uds
  • Let others know about room or schedule changes: “Due to overflow crowds, remaining Xubuntu sessions have been moved to Big Texas Conference Hall B. #UDS”  (Ok, I made up that dent.  I can dream, though, can’t I?)
  • Inform others (okay . . . complain) about conditions at the conference: “Hmmm, my laptop kept me nice and warm during the pleniary sessions, but it’s still cold in the rooms. Anyone want to max my CPU? !uds“  After all, the conference organizers pay good money to an event site to host their event there, so rooms should be comfortable for attendees.
  • Share technical information from a session (aka “live-tweeting” a session): “# “package-branches” is the tag used for bugs (in #) related to source package branches.” Notices like these may not make sense to everyone, but they will likely make sense to those interested in the topic.
  • Presenters can use identi.ca or twitter as a presentation tool, too.  For example, Tom Johnson recently wrote an article noting that presenters can pose questions to their audience, and let the audience respond via Twitter.  This can provide for real-time feedback to the presenter about a particular topic, and can help to break down some of the barriers between the audience and the presenter.

Of course, I expect that people will use microblogging for fun, too.  I wouldn’t want for people to feel uptight about their tweets.  I just wanted to share a couple of thoughts for how people can better use microblogging at a conference, thus making things more enjoyable for those in attendance, and for those who are participating remotely.  If you have any other suggestions, feel free to share them in the comments.

Posted on Mar 31, 2009

At the documentation conference

I’m attending the WritersUA conference in Seattle this week, and yesterday was day one of the conference.  The conference started with Scott McCloud talking about how he created his Google Chrome comic, and I attended other talks on ISO documentation standards, as well as architecting your content so it can be reused.

McCloud’s talk was interesting in a number of ways, but one aspect of it that struck me was the volume of work went into what he did.  The initial basis of the work was 10 dvd’s worth of recorded interviews with developers.  They did not allow the content of the comic book form to be dictated by some kind of marketing storyline.  The comic still stood up as a form of documentation.

Additionally:
* The use of bubbles as text-placeholders in the comic created some difficulties for translators, but they were able to make things work. He didn’t provide a great amount of detail about this.
* He loved the mash-ups that resulted from the work being licensed under a Creative Commons license, even if the mash-ups didn’t follow the letter of the license.  Google did not attempt to sue people who made these mashups for noncompliance with the license.
* He demonstrated how comic book framing can keep the use focused on one item at a time, and make it easier to explain difficult concepts in an elegant, easy-to-understand way.
* I think he referenced XKCD at least 3 times.  He likes it.
* I can’t draw comics.  :/  Maybe I can use some of this stuff with screenshots, though.

I also attended a session on ISO standards for documentation and D.I.T.A., an open-source documentation toolkit similar to docbook.  The standard is maintained by OASIS, a not-for-profit standards organization – it looks great!  We got to see snippets of it, but it costs about $200 to get a single copy of the standard. :/  Even members of the OASIS committee who volunteer to maintain the standard have to pay to get a copy of it.  I am glad that at I don’t have to pay to contribute to Ubuntu.

The best session of the day for me was the session on architecting documentation for reuse.  The Ubuntu documentation team already has some of our content architected for reuse; for example, we use docbook “entities” for repetitive items such as system and software version numbers, Ubuntu website urls and certain procedures, but this showed how it’s possible to do more.  I’m a little green as a member of the Ubuntu documentation team, but I’m eager to learn more about this approach.