Difference between revisions of "Tools"

From IHE Wiki
Jump to navigation Jump to search
 
(16 intermediate revisions by 5 users not shown)
Line 1: Line 1:
The following proposal is organized by artifact/activity and is based on a presentation at the IHE International meeting Nov 2006.  Each entry describes What is done Where by Whom.  Hopefully this will provide some structure to the debate.
+
IHE Committees and participants have much information to record, distribute and have available for reference.
  
 +
The following proposal is based on a presentation at the IHE International meeting Nov 2006.
 +
 +
 +
IHE artifacts/activities are listed and, for each, a proposal for What is done Where by Whom.
 
* '''Items in Bold text''' are proposed to be mandated by IHE
 
* '''Items in Bold text''' are proposed to be mandated by IHE
* Items in Normal text are proposed to be IHE conventions
+
* Items in Normal text are proposed to be recommended by IHE as the default approach
 
* ''Items in Italic text'' are proposed as alternatives worth considering
 
* ''Items in Italic text'' are proposed as alternatives worth considering
  
The "Whom" listed is the default person responsible for it getting done.
+
The "Whom" listed is the default person responsible for it getting done,
In different domains/regions/committees the "Whom" may delegate the  
+
but in different domains/regions/committees the "Whom" may delegate the  
responsibility to someone else.  For example the Cochair and Secretariat  
+
responsibility to someone else.  For example, the Cochair and Secretariat  
 
might agree that the latter will maintain the roster.
 
might agree that the latter will maintain the roster.
  
Line 14: Line 18:
  
 
* Committee Roster
 
* Committee Roster
** '''Maintained on Wiki by the Committee Co-chair'''
+
** '''Maintained on Wiki by the Committee Secretary'''
 +
** '''Attendance Recorded on Wiki by the Committee Secretary'''
  
 
* Committee Meeting/T-Con Calendar
 
* Committee Meeting/T-Con Calendar
** Maintained on IHE Calendar by Co-chair
+
** '''Maintained on IHE Calendar by Committee Secretary'''
** Mirrored on Wiki by Cochair in Committee Timeline (for major events)
+
** Mirrored on Wiki (in Committee Timeline) by Cochair (for major events) - where is committee timeline?  define major event.
 +
** ''Mirrored on Wiki (on Committee Pages) by Cochair (for minor events)''
  
 
* Committee Discussions
 
* Committee Discussions
 
** Conducted on Google Groups by Members
 
** Conducted on Google Groups by Members
 
** Archived on Google Groups by Google
 
** Archived on Google Groups by Google
** Linked-to on Committee Page
+
** Linked-to from Wiki (Committee Page) by ?
 +
 
 +
* Commitee Meeting Minutes (both of the below?)
 +
** ''Archived on FTP site by Secretary''
 +
** ''Archived on Wiki (on Committee Pages) by Cochair ''
  
* Commitee Meeting Minutes
+
* Committee Votes
** Archived on FTP site
 
  
 
==Development Activities==
 
==Development Activities==
Line 34: Line 43:
 
** Announced (milestone headsup) on Domain Mailing List by Tech Cochair
 
** Announced (milestone headsup) on Domain Mailing List by Tech Cochair
 
*** Mirrored (cc’d) on Domain Coord Mailing List by Tech Cochair
 
*** Mirrored (cc’d) on Domain Coord Mailing List by Tech Cochair
*** Mirrored (cc’d) on Region Cochairs Mailing List by Tech Cochair
+
*** Mirrored (cc’d) on Region Cochairs Mailing List by Tech Cochair (meaning tech cochair must be on the region cochair mailing list?  is this generally true?)
*** Mirrored on other Domain & Region Mailing Lists (as appropriate) by Domain/Region Cochairs
+
*** Mirrored on other Domain and Region Mailing Lists (as appropriate) by Domain/Region Cochairs
 
** Presented on IHE.net by Secretariat?
 
** Presented on IHE.net by Secretariat?
  
* Draft Supplements
+
* Draft Supplements - one of the below, choice up to Tech Cmte Editor
** Authored in Word by Tech Cmte Members
+
** Authored in Word by Tech Cmte Members using [ftp://ftp.ihe.net/Document_templates/IHE%20Supplement%20Template-V7.1.doc MS-Word Supplement Template]
** Authored on Wiki by Tech Cmte Members
+
** Authored on Wiki by Tech Cmte Members using Wiki [[Profile Template]]
  
 
* Public Comment Supplements
 
* Public Comment Supplements
Line 46: Line 55:
 
** Archived on FTP by Tech Cmte Editor
 
** Archived on FTP by Tech Cmte Editor
 
** Rendered in PDF by Secretariat
 
** Rendered in PDF by Secretariat
** Published/Linked-to on Wiki by Secretariat
+
** Published/Linked-to on Wiki by Secretariat (should point to ihe.net, state where in wiki this should be)
 +
** Published/Linked-to on IHE.net
  
* Public Comments
+
* Public Comments (Choose only one way to do this, don't have two different ways)
 
** Submitted on Committee Mailing List (in Excel) by Members
 
** Submitted on Committee Mailing List (in Excel) by Members
 
** Submitted on Public Comment List by Public
 
** Submitted on Public Comment List by Public
Line 59: Line 69:
 
** Linked-to on Wiki
 
** Linked-to on Wiki
  
* CPs [see CP discussion or copy summary here]
+
* CPs [see CP discussion or copy summary here] - put link here
  
 +
* Implementation Material
 +
** [[INRIA Gforge Implementation Material]]
  
 
==Implementation Activities==
 
==Implementation Activities==
Line 76: Line 88:
 
** Link to region web page?
 
** Link to region web page?
  
 +
* [[Implementation|Implementation and Testing Tools]]
  
 
==Education Activities==
 
==Education Activities==
Line 112: Line 125:
  
  
==Communication Tool Descriptions==
+
==Communication Tools==
 
These are the primary tools for persistent communications.
 
These are the primary tools for persistent communications.
 
Non-persistent tools like Webex, Skype, IM, T-Con are "unconstrained" for now.
 
Non-persistent tools like Webex, Skype, IM, T-Con are "unconstrained" for now.
Line 136: Line 149:
 
** Some problems with delays in mailing?
 
** Some problems with delays in mailing?
  
* IHE FTP - ftp.rsna.org
+
* IHE FTP - ftp.ihe.net
** should we rename to ftp.ihe.net?
 
 
** Strength: Easy bulk download, file hierarchy
 
** Strength: Easy bulk download, file hierarchy
 
** Primary Use: Document Archive
 
** Primary Use: Document Archive
Line 145: Line 157:
  
 
* IHE Connectathon Website – www.connectathon.net
 
* IHE Connectathon Website – www.connectathon.net
 
  
 
==Secondary Communication Tools==
 
==Secondary Communication Tools==
Line 154: Line 165:
  
 
==Wiki Conventions==
 
==Wiki Conventions==
 +
 +
===Accounts===
 +
You do not need an account in order to view pages on the IHE Wiki. You do need an account in order to edit pages, however. Click on the "log in" link at upper right, then click "request an account" and complete the brief information form. Your request will be reviewed by IHE International secretariat. Only members involved in committee activities will be granted accounts. Expect review and response within 5 days. If you do not get a response, please send a follow-up email to secretary@ihe.net.
 +
  
 
===Page Naming===
 
===Page Naming===
  
'''<Some naming conventions are already listed in the relevant page templates>'''
+
In general follow the naming protocol used for analogous documents (eg, agendas, profile proposals) in the domains/committees in which you are active. Some more specific naming conventions are provided in relevant page templates.
  
 
===Revision Reference Points===
 
===Revision Reference Points===

Latest revision as of 11:56, 22 October 2013

IHE Committees and participants have much information to record, distribute and have available for reference.

The following proposal is based on a presentation at the IHE International meeting Nov 2006.


IHE artifacts/activities are listed and, for each, a proposal for What is done Where by Whom.

  • Items in Bold text are proposed to be mandated by IHE
  • Items in Normal text are proposed to be recommended by IHE as the default approach
  • Items in Italic text are proposed as alternatives worth considering

The "Whom" listed is the default person responsible for it getting done, but in different domains/regions/committees the "Whom" may delegate the responsibility to someone else. For example, the Cochair and Secretariat might agree that the latter will maintain the roster.


Committee Activities

  • Committee Roster
    • Maintained on Wiki by the Committee Secretary
    • Attendance Recorded on Wiki by the Committee Secretary
  • Committee Meeting/T-Con Calendar
    • Maintained on IHE Calendar by Committee Secretary
    • Mirrored on Wiki (in Committee Timeline) by Cochair (for major events) - where is committee timeline? define major event.
    • Mirrored on Wiki (on Committee Pages) by Cochair (for minor events)
  • Committee Discussions
    • Conducted on Google Groups by Members
    • Archived on Google Groups by Google
    • Linked-to from Wiki (Committee Page) by ?
  • Commitee Meeting Minutes (both of the below?)
    • Archived on FTP site by Secretary
    • Archived on Wiki (on Committee Pages) by Cochair
  • Committee Votes

Development Activities

  • Domain Timeline / Development Activity Events
    • Authored on Wiki by Planning/Tech Cochairs
    • Announced (milestone headsup) on Domain Mailing List by Tech Cochair
      • Mirrored (cc’d) on Domain Coord Mailing List by Tech Cochair
      • Mirrored (cc’d) on Region Cochairs Mailing List by Tech Cochair (meaning tech cochair must be on the region cochair mailing list? is this generally true?)
      • Mirrored on other Domain and Region Mailing Lists (as appropriate) by Domain/Region Cochairs
    • Presented on IHE.net by Secretariat?
  • Public Comment Supplements
    • Finalized in Word by Tech Cmte Editor
    • Archived on FTP by Tech Cmte Editor
    • Rendered in PDF by Secretariat
    • Published/Linked-to on Wiki by Secretariat (should point to ihe.net, state where in wiki this should be)
    • Published/Linked-to on IHE.net
  • Public Comments (Choose only one way to do this, don't have two different ways)
    • Submitted on Committee Mailing List (in Excel) by Members
    • Submitted on Public Comment List by Public
  • Technical Framework, Final Text Supp, Trial Implementation Supp
    • Finalized in Word by Tech Cmte Editor
    • Archived on FTP by Tech Cmte Editor
    • Rendered in PDF by Secretariat
    • Published/Linked-to on IHE.net by Secretariat
    • Linked-to on Wiki
  • CPs [see CP discussion or copy summary here] - put link here

Implementation Activities

  • Profile Implementation Guidance/FAQs
    • Author on Wiki by domain and Implementer Community
  • Integration Statements
    • Published on vendor sites by Vendors
    • Cataloged in Profile Registry by Vendors
    • Linked-to on IHE.net (IS Page) by Secretariat (at Vendor request)
  • Region Activity & Timeline
    • Author on Wiki by region
    • Link to region web page?

Education Activities

  • Profile Lists/One-line Descriptions
    • Author on Wiki (Profile List) by Planning Cmte
    • Illustrated on IHE.net by Secretariat (Marketing Cmte?)
  • Profile FAQs (for Users)
    • Author on Wiki by Planning Cmte
    • Linked-to on IHE.net (Profiles Page) by Secretariat
  • Regional Educational Events (including Demos)
    • Maintained on IHE Calendar by
    • Mirrored on Wiki (Region Page) by Region Cochair
    • List on Wiki Region and Domain pages?
  • Educational Presentations
    • Author in Powerpoint by Committee Members
    • Archive on FTP by Committee Members
    • Linked-to on Wiki (Workshop Pages) by Committee Members
    • Linked-to on Wiki (relevant topic/Profile Page) by Committee Members
  • Flyers and Brochures
    • Authored in (whatever) by Secretariat (based on raw materials in Wiki, etc)
    • Printed by Secretariat (and distributed wherever)\
    • Archived on FTP by Secretariat
    • Linked-to on Wiki and/or IHE.net (as appropriate)
  • User Discussions
  • Press Releases
    • Published on IHE.net by Secretariat
    • Mirrored to Mailing Lists (as appropriate) by each ML Moderator


Communication Tools

These are the primary tools for persistent communications. Non-persistent tools like Webex, Skype, IM, T-Con are "unconstrained" for now. Secondary tools are listed below.


  • IHE Website - www.ihe.net
    • Strengths: advanced presentation, strict publication process, stable
    • Primary Use: Professional/Glossy Presentation
  • IHE Wiki - wiki.ihe.net
    • Strengths: easy edit, “live”, change tracking, “notification"
    • Primary Use: Authoring, Collaboration
    • Material that gets incrementally updated, multiple people contribute
  • IHE Calendar - www.rsna.org/ihe/calendar
    • consider transitioning to a Google based calendar?
    • A calendar that could filter and also provide both a monthly event calendar view and a sequential list of events/timeline view might remove the need to mirror the calendar.
  • IHE Mailing Lists - groups.google.com/group/IHE-group-name
    • Strengths: automatic, searchable archive/record of discussions
    • (all mailing lists are in the process of transitioning to Google Groups)
    • Some problems with delays in mailing?
  • IHE FTP - ftp.ihe.net
    • Strength: Easy bulk download, file hierarchy
    • Primary Use: Document Archive
  • IHE Forums - forums.rsna.org
    • transition to google mailing list?
  • IHE Connectathon Website – www.connectathon.net

Secondary Communication Tools

  • Regional IHE Websites
  • wikipedia.org
  • Brochures and Flyers


Wiki Conventions

Accounts

You do not need an account in order to view pages on the IHE Wiki. You do need an account in order to edit pages, however. Click on the "log in" link at upper right, then click "request an account" and complete the brief information form. Your request will be reviewed by IHE International secretariat. Only members involved in committee activities will be granted accounts. Expect review and response within 5 days. If you do not get a response, please send a follow-up email to secretary@ihe.net.


Page Naming

In general follow the naming protocol used for analogous documents (eg, agendas, profile proposals) in the domains/committees in which you are active. Some more specific naming conventions are provided in relevant page templates.

Revision Reference Points

An plus & minus of Wiki pages is that they more dynamic than other modes of collaboration.

For certain pages, it may be useful to periodically benchmark a version that everyone has agreed to, but still not prevent further contributions and collaboration.

A "notary" (e.g. Chris or Didi) could edit the page and save it with a Summary comment or "OFFICIAL" or "CONCENSUS" or somthing.

This would allow people to continue to provisionally evolve the page contents, but if anyone wanted to see the last version that everyone officially agreed to, they could click on "history" and click the last version edited by a notary as "OFFICIAL". Further, you can use the comparison feature to see the delta of what has changed since.