A directory of resources inthe field of technical communication.


51-74 of 112 found. Page 3 of 5.

About this Site | Advanced Search | Localization | Site Maps


A wiki is a page or collection of Web pages designed to enable anyone who accesses it to contribute or modify content, using a simplified markup language. Wikis are often used to create collaborative websites and to power community websites, usually as a very simple form of content management.



The "Quick Web" for Technical Documentation   (PDF)

So how did the wiki become a seemingly permanent fixture in the landscape of today’s Web? Which wikis have succeeded as technical documentation, and how can we replicate their success?

Gentle, Anne. Intercom (2007). Articles>Documentation>Technical Writing>Wikis


Ramping Up on Mediawiki

Previously I thought wikis might be limiting because the formatting options seemed so primitive--either bullets or numbers or headings, and not much else. Now I realize that I have so much to learn. I’m only on stair three of about a hundred stairs.

Johnson, Tom H. I'd Rather Be Writing (2009). Articles>Documentation>Content Management>Wikis


Review: Review of Alan Porter’s Wiki: Grow Your Own for Fun and Profit

Alan Porter’s Wiki: Grow Your Own for Fun and Profit, published by XML Press in October 2010, provides an excellent introduction to wikis. This is a short, easy-to-read book spanning about 150 pages. Porter has a keen sense of organization and liveliness in his writing. He carries the gardening metaphor throughout the book, ending with five solid case studies and an extended response to common criticisms against wikis.

Johnson, Tom H. I'd Rather Be Writing (2010). Articles>Reviews>Content Management>Wikis


Reviewing Wiki Documentation via Crucible

I have been playing around with Crucible, Atlassian’s peer code review tool. The latest version of Crucible allows you to review Confluence wiki pages. This is a new feature, so I decided to try it out. Also, I was wondering why you might want to use an independent tool to review a wiki page, when you could instead just add comments to the page or update the page directly.

Maddox, Sarah. ffeathers (2009). Articles>Web Design>Documentation>Wikis


Review: A Short Review of Writing in the Open: Using Wikis to Create Documentation

Wikis are becoming entrenched in the documentation world. But there are few books that cover how to use them effectively. If you’re looking for a step-by-step guide to using wikis to create and deliver documentation, Writing in the Open isn’t it. It is, though, an interesting and potentially useful set of best practices.

Nesbitt, Scott. DMN Communications (2010). Articles>Reviews>Wikis>Documentation


Should Technical Authors Embrace User-Generated Content?

It may seem counter-intuitive, but we believe technical authors shouldn't fear the trend towards user generated content.

Cherryleaf. Articles>Writing>Technical Writing>Wikis


Six Reasons Why Your Wiki Isn’t Working

Wikis are a great way to create and publish documentation online, but there are many wikis that haven’t worked. They comprise just a few pages of incomplete, out of date information. Why is that? Why do some wikis work and others just fail? Here are six key reasons.

Pratt, Ellis. Cherryleaf (2009). Articles>Content Management>Wikis>Social Networking


A Small Business Guide to Wikis

Social technology has risen to meet this challenge over the last few years. And while there are a lot of social tools to choose from, one type stands out for this type of collaboration: the wiki. The unique communication model inherent in the wiki makes it ideal for becoming a central business tool for your entire team. The following is an overview of using wiki software for small business.

Parr, Ben. Mashable (2009). Articles>Web Design>Business Communication>Wikis


Strategies for Driving Down the Cost of Product Documentation: Wikis and DITA   (PDF)

The process of creating and maintaining product documentation is, like most other business processes, under pressure to reduce costs, reduce cycle times, and support companies as they compete on a more global scale; in general, the need to do more with less. How are companies to address these conflicting needs? The purpose of this white paper is to identify specific processes that can be enhanced to yield meaningful efficiencies and several strategies for attaining such improvements.

Info Pros (2007). Articles>Documentation>Wikis>DITA


Talking About Wikis with Stewart Mader

An interview done by Scott Nesbitt of DMN Communications. Nesbitt talks with Stewart Mader, author of the book WikiPatterns. In the interview, Nesbitt and Mader discuss adopting wikis, how best to use them in an organization, building communities around wikis, and why Mader is so passionate about wikis.

Nesbitt, Scott and Stewart Mader. DMN Communications (2008). Articles>Interviews>Wikis>Podcasts


Teaching Technical Communication with Wikis

Wiki technology creates opportunities for students in technical communication courses to gain experience with web design, writing for the web, and open-ended projects. As tools for collaborative learning, they also develop students’ project management skills and teamwork abilities. This article discusses the affordances, pedagogical foundations, and practical benefits of teaching with wikis, and suggests ways that technical communication instructors might incorporate this technology into their courses.

Scott, Jennifer Bracken. Xchanges (2010). Articles>Education>TC>Wikis


Technical Communication Body of Knowledge

The STCs BoK attempts to organize, make accessible, and connect together the plethora of information necessary to train for and practice within the profession of technical communication.

STC (2014). Resources>TC>Education>Wikis


Technical Writing in a Wiki - Content Re-use and Structure

Craft it with care. Review it with your Subject Matter Experts. Keep it in a central location and regularly maintain and update it. Re-use it as required. This is the third of a series of posts from Atlassian's Technical Writing Team focusing on using a wiki for technical writing. The second post in this series discussed how many people still think of a wiki as an unstructured collection of pages, but in fact wikis do support structured content. In this post, I'll be talking about how to leverage that structure in support of content re-use.

Hawse, Sally. Atlassian Blog, The (2011). Articles>Content Management>Technical Writing>Wikis


Technical Writing in a Wiki - Documentation Release Management

This is the fourth in a series of posts from Atlassian's Technical Writing Team focusing on using a wiki for technical writing. Last week, Sally Hawse wrote about time-saving ways to re-use content. In this post, I'll be talking about how to manage the documentation release process using Confluence.

Jameson, Rosie. Atlassian Blog, The (2011). Articles>Documentation>Technical Writing>Wikis


Technical Writing in a Wiki - Single Source Publishing

As technical writers, we always keep our readers' and customers' needs at the forefront of our minds. One of the most basic requirements is that our readers will have access to the documentation. No matter what tool we use to write the documents, we must be able to publish them in various output formats depending on where our readers are and the tools they have at their disposal.

Maddox, Sarah. Atlassian Blog, The (2010). Articles>Content Management>Single Sourcing>Wikis


Technical Writing in a Wiki: from Draft to Published Document

This is the second in a series of posts from Atlassian's Technical Writing Team focusing on using a wiki for technical writing. Last week, Andrew Lui talked about why wikis are ideal for collaborative documentation development. In this post, I'll be talking about how you can use a wiki to publish documentation, from authoring content through to publishing.

Gaskell, Giles. Atlassian Blog, The (2011). Articles>Writing>Technical Writing>Wikis


The Rise Of Hyperlocal Information

The net effect of social networking is the increasing availability of fine-grained information about locales. This information is both interesting and valuable. It is sought after by people living in these places and by advertisers who are trying to reach these people. A handful of startups are recognizing the big potential of local information - relevance. In this post we look at different aspects of the hyperlocality, from satellites to local blogs, and ponder how this information will be organized and monetized.

Iskold, Alex. ReadWriteWeb (2008). Articles>Information Design>Content Management>Wikis


Thinking Outside the Book

The notes for a presentation (titled Thinking Outside the Book: Wikis for Writing and Delivering Documentation, that discusses the whys, the tools, and the techniques of using wikis for documentation.

Nesbitt, Scott. DMN Communications (2009). Presentations>TC>Wikis>Documentation


This is the Future of Technical Communication

In the absence of safety concerns, I think that accuracy must win. Thus, as the information curator, you have a responsibility to correct inaccurate information. If the inaccuracy is truly dangerous, you may need to edit the post directly. Make sure that you disclosure what you've done with brackets.

O'Keefe, Sarah S. Palimpsest (2009). Articles>TC>Technical Writing>Wikis


Threats to the Sustainability of an Organizational Content Strategy

This project began as a course project at Michigan State University for WRA 420: Content Management for Professional Writers. The aim of the project is to build a compendium of threats to the sustainability of organizational content strategies by offering an analysis that comes from our own research, and also from reviewing literature in the field of technical communication on content management. The intended audience for this project are fellow content strategists, students, teachers and research specialists who may find themselves in a position to make recommendations for improving the content strategy of organizations.

PBwiki (2010). Resources>Content Management>Content Strategy>Wikis


User-Generated Content

Let’s say that you’re reading a news story about a particular area of geographic conflict and you decide to investigate further. Without an encyclopedia available, as fewer and fewer of us seem to have them on hand these days, you quickly check out your handy online references. To your surprise, the article on this disputed feature seems to be an amalgamation of strongly differing opinions and ideologies, to the point where the article has been locked down from further editing. Such is the nature of the brave new world of user-generated content, where a content publisher forges a careful alliance of sorts with a wide range of contributors across very diverse locales and cultures. Depending on the intended purpose of the provided content, the end result can take on a life of its own, as it becomes the focal point for a silent yet fervent battle over “fact” and “truth” from divergent viewpoints.

Edwards, Tom. TC World (2009). Articles>Content Management>Wikis>Social Networking


User-Generated Content and the “Official” Documentation

Does user-generated and third-party documentation drive people away from the so-called official documentation? Maybe yes, maybe no.

Nesbitt, Scott. DMN Communications (2010). Articles>Documentation>Technical Writing>Wikis


Using a Wiki as an Organizational Portal

We explain why we chose a wiki-based content management system (CMS) as the basis for the portal for KeyContent.org. We compare various tools and discuss other sites that have implemented similar software for collaborative solutions.

Albing, Bill and Rick Sapir. KeyContent.org (2006). Presentations>Technology>Organizations>Wikis


Using a Wiki for Technical Documentation   (PDF)

Is it possible to use a wiki for technical documentation? Yes, most definitely. I started working on a wiki two years ago, with no prior experience of wikis (apart from the occasional encounter with Wikipedia) but with plentiful experience of technical writing. I’ve learned a lot and I’d like to pass on some tips to you too.

Maddox, Sarah. Southern Communicator (2009). Articles>Documentation>Content Management>Wikis


Using a Wiki to Write About Wikis   (peer-reviewed)

Academic writers are used to having their ideas encapsulated and enshrined in printed text (e.g., a journal article or a book), but publishing them in a wiki strips them of this protection. What happens when strangers change our writing? Since the traditional academic publishing paradigm has not caught up with the open-editing, peer-to-peer model, are we equipped to deal with the paradigm shift that wikis represent? These are issues we consider in this short piece.

Wilder, Hilary and Sharmila Pixy Ferris. Journal of Electronic Publishing (2007). Articles>Writing>Content Management>Wikis



Follow us on: TwitterFacebookRSSPost about us on: TwitterFacebookDeliciousRSSStumbleUpon