This wiki has undergone a migration to Confluence found Here
<meta name="googlebot" content="noindex">

Difference between revisions of "Collaborative Technologies"

From HL7Wiki
Jump to navigation Jump to search
Line 27: Line 27:
 
What should probably '''not''' be on the Wiki:
 
What should probably '''not''' be on the Wiki:
 
#Fixed artefacts - this is better left to a document repository (or HL7 website), with version control mechanisms. ANSI requires that minutes and artefacts be available to all (the HL7 website is better suited for this than the Wiki). Examples: models (e.g. Visio), Publication Databases, Ballot.
 
#Fixed artefacts - this is better left to a document repository (or HL7 website), with version control mechanisms. ANSI requires that minutes and artefacts be available to all (the HL7 website is better suited for this than the Wiki). Examples: models (e.g. Visio), Publication Databases, Ballot.
 +
#On-line discussion through the wiki. We have e-mail discussion lists, teleconferences and face-to-face meetings as a more appropriate mechanism. These discussions yield at some point a consensus position (potentially through a motion) - that position as well as other notes from the meetings where it is discussed can in turn be added to the Wiki. (This role of Wikis is also documented in the above "what are Wikis suited for" list)
  
 
=== Various Wiki Notes ===
 
=== Various Wiki Notes ===

Revision as of 17:11, 26 May 2006

Wiki Nite

The third edition of the "Wiki Nite" will be organized on September 12th during the Boca Raton WGM as one of the "open space" meetings. The aim of this meeting is

  1. to raise awareness of Wiki technology (and other collaborative technologies) to support the process of creating HL7 standards.
  2. to have a Wikimeet. A Wikimeet is a meeting of people within HL7 that use a Wiki. Being able to see the changes that are happening adds an interesting factor to the wiki philosophy. Simultaneously working on various areas of the Wiki in many cases provides a huge boost in productivity.

FYI: Wikimania 2006 (the annual Wiki meeting) is planned for August 4-8, 2006, at Harvard Univ., Boston USA.

Wiki

Introduction

A Wiki is a good tool for the editing of "dynamic" documents as part of a collaborative process.

How Wikis support a TC/SIG or collaborations between TC/SIGs:

  1. Consensus process for an issue. A highly contentious issue (lots of e-mail traffic on the lists) can be halted after initial discussion. The HL7 listserves occasionally erupt into lengthy back-and-forth discussions that have diminishing information value to the majority of list-readers. If there was a better mechanism to move those discussions to a more focused venue, many people would be grateful. A summary can be posted to the Wiki, for all partcipants to edit, until a consesus version has been reached. This is one of the possible benefits of a Wiki to HL7: it reduces traffic on listserves. Once consesnus has been reached, the contents of the page can be frozen, and the content can be included in a ballot.
    1. May cause an issue to drop off the radar screen for listserve lurkers once it has been moved to Wiki
  2. Glossary items
  3. Harmonization proposals. Use the Wiki to publish the proposal, use it to collect comments during a public comment period prior to the harmonization meeting. Update with discussion + harmonisation result during the harmonisation meeting (i.e. supports the harmonisation meeting itself as well). This provides real-time feedback to all as of the latest status and outcomes of the harmonisation proposal.
  4. Agenda (e.g. for a WGM)
  5. Meeting minutes. The meeting minutes can be created during the meeting and saved every few minutes. That way all participants are able to review the minutes and make suggestions as to improvements during the call/meeting. A few days after the meeting (when all corrections have been made) the contents of the page can be frozen.
  6. Action item list
  7. During a WGM: for each TC/SIG, post (on a daily basis) a summary of issues that were discussed and that may have an impact on other comittees. Or: highlights in general.
  8. Development of cross committee storyboards (PA/FM/PM are testing this).
  9. More anonymous as a forum than an e-mail list for FAQs.
  10. Management of change requests, including discussion notes, and resolution.

What should probably not be on the Wiki:

  1. Fixed artefacts - this is better left to a document repository (or HL7 website), with version control mechanisms. ANSI requires that minutes and artefacts be available to all (the HL7 website is better suited for this than the Wiki). Examples: models (e.g. Visio), Publication Databases, Ballot.
  2. On-line discussion through the wiki. We have e-mail discussion lists, teleconferences and face-to-face meetings as a more appropriate mechanism. These discussions yield at some point a consensus position (potentially through a motion) - that position as well as other notes from the meetings where it is discussed can in turn be added to the Wiki. (This role of Wikis is also documented in the above "what are Wikis suited for" list)

Various Wiki Notes

  • There are various offerings of Wiki-software, some of which allow enhancements to the original Wiki concept by providing modules that allow the "freezing" of the content of a page, or agenda functionality to monitor action items.
  • The current Wiki software (MediaWiki) has some limitations. There is another potential Wiki tool called TWiki which offers additional functionality. This has lead to a Proposed change from MediaWiki to TWiki for the HL7 Wiki contents.
  • It is a good idea to create Template Pages that can be used (copied) as a starting structure, to be filled in by those that use the template. Example template: meeting minutes, agenda.
  • There is a MS-Word macro to transform Word documents into Wiki documents (Wiki uses a very simple markup language, but some transformation is needed)

Organizational issues

  • Management of the Wiki: who will take responsibility for vetting the information placed in the HL7 Wiki? What should the HL7 Wiki Etiquette look like ?
    • One of the nice aspects of a Wiki site is the opportunity to have free exchange of thoughts. The challenge is that changes are made more easily and is therefore subject to proper wiki etiquette and discipline, as well as that at any point in time the site may not be reflective of the collective consensus on a particular topic. Simple Wiki etiquette requires that contributors stick to facts and consensus on the main pages. The comments/talk/discussion pages are for anything that is questionable, controversial, or unsettled. Wiki Moderators need a effective way of discouraging heated open disputes.
    • The option of "freezing" of pages (a lockout) should probably be limited to co-chairs.
  • Do we need a Wiki that is maintained/controlled/administered by HL7.org, and if so, how do we arrange this?
    • A knowledgeable team is needed to manage/update the Wiki software. Mayo is willing to host the HL7 Wiki until such a time that HL7 decides to host it, and provided that use of (human) resources is limited.
  • Normative status of the Wiki content. A combination of a wiki site and a web site, one flowing freely and openly knowing that it is such a dynamic site, the other controlled and reflective of agreed to direction and "sanctioned" materials, suits the combined needs. In a way the wiki is no more sanctioned then the cumulative list server activity, but easier to get the bigger picture of a discussion. Once consensus has been reached on the Wiki, the content can be frozen and included in a ballot.

gForge

gForge is probably best known as the software used by sourceforge website. It has all kinds of features that support software development (version control, issue tracking, etc.). It is currently used by the Tooling comittee to support the development process of software.

Wikis and gForge are complimentary rather than conflicting. GForge allows tracking logs and fixed documents. Wiki allows dynamic documents. The support for the tracking of Action Items is better in gForge.

Skype/IRC

Technologies like Skype & Instant Messaging (IRC, ICQ, Yahoo Messenger, MSN, etc.) are especially used during WGMs for "cross-comittee consultations". The parties involved are taking part in committee meetings of separate committees, but are able to briefly consult a domain-expert which is in another meeting.

More information and hints on the free Skype program can be found at Skype Introduction and Guide.

For the most effective use of Instant Messaging, check out the free multi systems IM client Trillian, see Introduction and Guide to Free and Open Software. The "Trillian" free software allows you to chat with all your IM contacts (ICQ, Yahoo, AOL, MSN, etc.) using one program, rather than a separate IM client (eg. Yahoo Messenger, MSN, ICQ, etc.) for each. Download the free version from www.CerulianStudios.com. A pay-for version provides some extra functions.