Invitation to webinar – Wiki: what works and what hurts

TCANZ, the Technical Communicators Association of New Zealand, will host a webinar on 25th/26th of June, at which I’ll present a session called “Wiki-based documentation: What works and what hurts“. I’d love it if you could join us.

The webinar is a live, online presentation. We’ll see social and collaborative documentation in action, on the Atlassian documentation wiki.

What’s the aim of this webinar?

I’ll show you what’s great about technical communication on a wiki.

But you’ve probably heard a lot about that already, from me and other wiki technical writers. So I’d also like to talk about the aspects of wiki-based documentation that are more tricky, and share some hints about what our technical writing team is doing about those areas.

The TCANZ webinar page has more details about the content of the session.

Date, time and registration

If you’re in the Asia-Pacific region like me, you’ll be delighted to know that this webinar happens at a civilised time of day for us. πŸ™‚

Date: Tuesday 26th June 2012 (which is Monday 25th June in some parts of the world)

Time: 11:00 a.m. on Tuesday 26th June in New Zealand
9:00 a.m. on Tuesday 26th June in Sydney
4 p.m. on Monday 26th June in California
7 p.m. on Monday 26th June in New York

You can use the WorldTimeServer to see the time in your own time zone.

Fee and registration: See the TCANZ webinar page.

About Sarah Maddox

Technical writer, author and blogger in Sydney

Posted on 9 June 2012, in technical writing, wiki and tagged , , , , , . Bookmark the permalink. 2 Comments.

  1. I hope that you discuss how (or if) we can use the different types of labels to improve findability of pages in and across spaces. For example, because the page title ranks first in searches, does it make sense to add a label that contains a word in the title? Do space labels have any effect when searching across spaces? Is the ranking the same? Because age of a page affects ranking, other than constantly editing a topic, how can you ensure that important topics remain high in the search results?

    • Hallo Melody

      Those are really good questions. They don’t fit so well into the theme of this webinar, so I’ll do my best to answer them here. But please ask the question again during the webinar, if there’s something I’ve missed.

      It sounds as if you already know a fair bit about Confluence labels. πŸ™‚ You can probably give me a hint or two too.

      By default, the Confluence search works across all spaces. There’s no higher ranking given to the space in which you happen to be, when you start the search. (BTW, the development team is working on an “archive” feature, which will allow us to mark a space as archived. That would prejudice the space’s pages in the search results. That feature is not yet in Confluence, but we’re hoping for it soon!)

      The space labels don’t have any effect on search results, when searching for pages.

      Yes, it does make sense to add a word as a label, even if the word appears in the title. The occurrence of the word in the label will raise the ranking of the page, so that it will appear higher in the search results.

      The age of the page has only a slight effect on the ranking, so it should be outweighed by other ranking techniques, such as using the relevant words in the title, labels, and content of the page.

      Here’s a page that describes the ranking of search results in Confluence:

      I hope this is useful. See you at the webinar!


Leave a Reply to ffeathers Cancel reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.

%d bloggers like this: