A directory of resources inthe field of technical communication.

Wikis

115 found. Page 1 of 5.

About this Site | Advanced Search | Localization | Site Maps
 

1 2 3 4 5  NEXT PAGE »

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.

 

1.
#37192

Advocate for Community Documentation

Let’s say that the most driven and driving developer on your team, who also happens to be a popular blogger, comes to you and asks why your end-user documentation doesn’t allow comments or ratings. Rather than stammering something about Wikipedia’s latest scandal, or reaching for imperfect responses that sound like lame excuses, do your homework and learn best practices from others who are implementing social web content that is conversational or based on community goals.

Gentle, Anne. Just Write Click (2010). Articles>Documentation>Wikis>Social Networking

2.
#29795

An Almost Final Farewell to Desktop Word Processing

The era of desktop publishing is over, and I must bid Microsoft Word and several other desktop applications good-bye. In case you think I'm singling out Microsoft, it's not just MS Word, but also OpenOffice, GoogleOffice, or any application that makes what we used to call 'documents'. Nowadays, I'm simply using a wiki for collaborative information sharing and a blog for online reporting.

Albing, Bill. Carolina Communique (2007). Articles>Word Processing>Online>Wikis

3.
#34576

Are Structured Authoring and Wiki Opposing Forces?

There are two camps in technical documentation. There’s the “quick web” folks who connect easily and author easily, and then there’s the “structured quality” camp that requires more thoughtful testing and time spent on task analysis and information architecture.

Gentle, Anne. Just Write Click (2007). Articles>Content Management>Information Design>Wikis

4.
#34779

The Atlassian Contributor License Agreement Comes of Age

In early March we opened up the Atlassian documentation to the wider community. We added a CC-by (Creative Commons Attribution) license to our product documentation. We invited people to contribute to our documentation after signing an Atlassian Contributor License Agreement (ACLA). At that stage, the ACLA was just starting its three-month trial. The trial period has now ended, and we're delighted to say: it's a go!

Maddox, Sarah. Atlassian Blog, The (2009). Articles>Documentation>Wikis>Case Studies

5.
#36046

Author-it User Wiki  (link broken)

One of the strengths of the Author-it is the help and support that members of the Author-it User Group provide to each other. But it occurred to me a lot of this useful information is lost and buried in the mountain messages and not captured anywhere. I also thought that it would be useful to have a repository of this great information.

Blunck, Hamish. HamishBlunck.com (2009). Articles>Documentation>Wikis>Author It

6.
#31107

Baselining Documentation on a Wiki

The dynamic nature of wikis can cause a few headaches when you need to baseline documentation that's on a wiki to correspond with the release of your product. This blog post looks at some ways in which you can try baselining wiki content.

DMN Communications (2008). Articles>Documentation>Technical Writing>Wikis

7.
#25056

Beyond the Blog: Wikis and Blikis

Blogs are about to give way to a new development. Wikis are web sites within which any user can quickly and easily edit much of the content, without HTML. This idea regarding user-generated online content goes beyond the comment posting of a standard blog. Blikis are blogs that have wiki support, so that users can edit the comments posted.

Streight, Steven. Blogger.com (2005). Articles>Web Design>Wikis>Blogging

8.
#32816

Building a DITA-Wiki Hybrid  (link broken)   (PDF)

Learn about theoretical and practical examples of merging DITA (Darwin Information Typing Architecture), a structured authoring methodology, and wiki’s freeform authoring and editing capabilities.

Gentle, Anne and Lisa Dyer. Intercom (2008). Articles>Documentation>Technical Writing>Wikis

9.
#35293

Building Web Pages With HTML 5

Depending on who you ask, HTML 5 is either the next important step toward creating a more semantic web or a disaster that's going to trap the web in yet another set of incomplete tags and markup soup. The problem with both sides of the argument is that very few sites are using HTML 5 in the wild, so the theoretical solutions to its perceived problems remain largely untested.

Webmonkey (2009). Resources>Web Design>Wikis>HTML5

10.
#31882

Businesses not as Keen on Blogs and Wikis? We Had a Hunch

Despite all the excitement in the technical communications community over Web 2.0 technologies like wikis and blogs, it looks like companies are still reluctant to tie the knot for a variety of reasons.

DMN Communications (2008). Articles>TC>Wikis>Blogs

11.
#31114

Can Lightweight Markup Languages Be Used for Documentation?

A lightweight markup language uses syntax that is similar to wiki syntax -- keyboard characters are used to define formatting. This blog post argues that if your documentation needs are simple, and you have a low or non-existent budget, then a lightweight markup language might be worth investigating.

DMN Communications (2008). Articles>Documentation>Programming>Wikis

12.
#32896

Can Wikipedia Be Trusted?

The intention of this article is to open the readers eyes to the issues with trusting user edited content. Over time, the Wikipedia may balance out. Eventually, or possibly even now, user tests are being performed to see how much content is credible. Also, the academic communities could step up and decide unanimously that the Wikipedia is not a trusted body of information to use for research. Once this happens the Wikipedia will have to change the way information within their pages is handled to maintain existence.

Hall, Lawrence. Content Matters (2006). Articles>Research>Online>Wikis

13.
#37377

Capabilities and Roles of Enterprise Wikis in Organizational Communication   (peer-reviewed)   (members only)

The article alerts technical communicators to wiki technology, an emerging new medium that allows dispersed groups to create shared content via collaborative editing and different-time communication. Wiki-based collaborative content creation enables new communication practices and thereby challenges several assumptions of existing media choice theories.

Wagner, Christian and Andreas Schroeder. Technical Communication Online (2010). Articles>Content Management>Wikis>Collaboration

14.
#35025

Care to Write Army Doctrine? With ID, Log On

In July, in a sharp break from tradition, the Army began encouraging its personnel — from the privates to the generals — to go online and collaboratively rewrite seven of the field manuals that give instructions on all aspects of Army life. The program uses the same software behind the online encyclopedia Wikipedia and could potentially lead to hundreds of Army guides being “wikified.” The goal, say the officers behind the effort, is to tap more experience and advice from battle-tested soldiers rather than relying on the specialists within the Army’s array of colleges and research centers who have traditionally written the manuals.

Cohen, Noam. New York Times, The (2009). Articles>Content Management>Documentation>Wikis

15.
#30550

Catalyze

Catalyze is a member-driven community for all professionals involved in defining business systems, designing software applications and creating websites. If you are a business analyst, usability professional, UI designer, information architect, interaction designer, product manager, project manager or anyone else involved in the definition process of software applications, this community is for you and will be worth your time.

Catalyze. Resources>Business Communication>Usability>Wikis

16.
#35525

Consistency and Community-Generated Content

I’ve been collecting examples of wildly inconsistent writing lately. I’m not sure why these have stuck out to me, but when I think of book sprints and community writing events, consistency is an important, though sometimes difficult, goal and outcome.

Gentle, Anne and Janet Swisher. Just Write Click (2009). Articles>Documentation>Style Guides>Wikis

17.
#36861

Constructive Interference: Wikis And Service Learning In The Technical Communication Classroom   (peer-reviewed)   (members only)

Four service-learning projects were conducted in technical communication courses using wikis. Results confirm previous findings that wikis improve collaboration, help develop student expertise, and enact a “writing with the community” service-learning paradigm. However, wikis did not decenter the writing classroom as predicted by previous work. Instructors using wikis to scaffold client projects should calibrate standards for evaluation with students and client, and they may need to encourage clients to stay active on the wiki.

Walsh, Lynda. Technical Communication Quarterly (2010). Articles>Education>Service Learning>Wikis

18.
#35124

Contributing to Wikis: A Useful Activity for Novice Tech Writers?

In this post, technical writer Milan Davidovic that contributing to wikis can help novices build skills and a portfolio. And he offers a simple roadmap for doing that effectively.

Davidovic, Milan. DMN Communications (2009). Articles>TC>Technical Writing>Wikis

19.
#32775

The Contribution Revolution: Letting Volunteers Build Your Business  (link broken)

Intuit’s cofounder challenges traditional companies to follow the lead of internet superstars—and of innovative peers such as Honda, Procter and Gamble, and Hyatt—in tapping the contributions of countless people beyond their organizations.

Cook, Scott. Harvard Business Review (2008). Articles>Management>Content Management>Wikis

20.
#34399

Control and Community: A Case Study of Enterprise Wiki Usage

There are a wide variety of uses for Wikis and a level of interest in using them that’s matched by an extensive range of Wiki software. Wikis introduce to the Internet a collaborative model that not only allows, but explicitly encourages, broad and open participation. The idea that anyone can contribute reflects an assumption that both content quantity and quality will arise out of the ‘wisdom of the crowd.’

Clarke, Matthew C. Boxes and Arrows (2009). Articles>Web Design>Content Management>Wikis

21.
#34752

Control and Community: A Case Study of Enterprise Wiki Usage

Like many companies, CorVu has extensive knowledge of its own products and a desire to make that knowledge available to customers. A major block to achieving that desire has been a lack of people with the time to either record the internal knowledge or to fashion the knowledge into a customer-ready format. We needed to spread the load so that a broad range of developers, tech writers, professional service consultants and others could all contribute what time and knowledge they had to a shared goal. Our hope was that a process built around several Wiki sites would facilitate this collaborative approach.

Clarke, Matthew C. Boxes and Arrows (2009). Articles>Content Management>Wikis>Case Studies

22.
#35914

Review: Conversation and Community by Anne Gentle

Offers a strong recommendation to read Anne Gentle’s Conversation and Community: The Social Web for Documentation, which provides tips for incorporating wikislices, screencasts, and comment/feedback systems, into your user assistance.

Mulligan, Peg. PegMulligan.com (2009). Articles>Reviews>Documentation>Wikis

23.
#33731

Creating Documentation With A Wiki: The DITA Storm Project

DITA is natural. Do XML/DITA conversion research now. Wiki is especially good for iterative writing. Structured wiki authoring in coming.

Abel, Scott. SlideShare (2007). Presentations>Documentation>Wikis>DITA

24.
#34492

Daisy: WYSIWYG Wiki for PDF Books   (PDF)

If you need the collaborative aspects of a Wiki combined with DITA's modular topics and publishing capabilities, then DAISY might just be the system you need--and it's free. DAISY provides WYSIWYG editing for Wiki pages that can be combined to publish books, either in a PDF or as a single HTML page.

Armstrong, Eric. Sun Microsystems (2008). Articles>Content Management>Documentation>Wikis

25.
#33733

DITA and Wiki Combo

What are your thoughts on whether wikis could be used for end-user technical documentation? I'd imagine that a more structured wiki based on DITA content (which may have already been created for end-users) might work well for technical documentation. Have you seen any good examples? I'd love to see a well-done example.

Gentle, Anne. BMC Software (2008). Articles>Content Management>Wikis>DITA

 
 NEXT PAGE »

 

Follow us on: TwitterFacebookRSSPost about us on: TwitterFacebookDeliciousRSSStumbleUpon