User Documentation

From DCMI_MediaWiki

Contents 1 User Documentation Task Group 1.1 Key deliverables (under construction) 1.1.1 Frequently Asked Questions (FAQ) 1.1.2 DCMI Glossary 1.1.3 User Guide 1.2 Workplan 1.3 Meetings and telecons 1.4 Related links

User Documentation Task Group

Co-Chairs: Mary Woodley and Tom Baker

Task group members: Stefanie Ruehle, Steven Miller, David Bromage, Julie Allinson, Marcia Zeng, Pete Johnston, Stuart Sutton.

The User Documentation Task Group was constituted in 2011 out of the de-facto merger of the User Guide Task Group and the Glossary Revision Task Group. The purpose of the new group is to edit and publish the revised User Guide authored by Stefanie Ruehle; to develop a new and streamlined glossary; and to maintain a new FAQ. These deliverables will include a series of essays that provide a historical perspective of how the DCMI and DCMES has evolved.

Membership in the Task Group is open to anyone interested in helping to edit and review basic documentation about metadata in the Dublin Core style. Discussion in the group takes place on an open mailing list and the group occasionally holds conference calls.

Key deliverables (under construction)

Frequently Asked Questions (FAQ)

• Frequently Asked Questions (FAQ)

DCMI Glossary

• "DCMI Glossary" - with links to mini-essays for disambiguation or historical context on:
  • Application profiles - needs to be written
  • DCMI Abstract Model
  • DCMI Metadata Terms
  • Description Set Profile
  • Domains and Ranges
  • "Dublin Core" - disambiguation page
  • "Dumb-down Principle"
  • "Encoding Scheme"
  • Metadata Enrichment
  • "Metadata Registry"
  • Namespace Policy
  • One-to-One Principle
  • Open-World Mindset
  • Resource Description Framework
  • Record Paradigm and Graph Paradigm
  • Resource Discovery and Resource Description
  • "Schema" - the word
  • "Simple Dublin Core"

User Guide

• "Using Dublin Core" - a user guide
  • "Creating Metadata"
  • "Publishing Metadata"

Workplan

Note: this revised workplan is based on the workplan of 4 December 2010.

• Migration to new wiki (DONE):
  • DONE: Migrate the draft User Guide ^[1][2][3] from the COLAB MediaWiki to the new DCMI MediaWiki and continue editing there (Tom and Stefanie). These documents will constitute a test case of the new DCMI MediaWiki as a publication platform.
  • DONE: Migrate the contents of Tom's mini-essays, FAQ, and Glossary entries -- as included in the Pittsburgh meeting packet ^[4] -- to the new MediaWiki.
  • DONE: Migrate the contents of the Glossary wiki ^[5] to the Media Wiki, possibly by converting from the HTML (Mary and Tom).
  • DONE: Migrate the Task Group page on dublincore.org to the MediaWiki ^[6] as a test of the viability of replacing the static Web page with a page on the MediaWiki.
  • DONE: Edit the documents as per our discussion in Pittsburgh ^[7].

• Future
  • Hold one or two telecons to assess progress.
  • Recruit additional participants to the discussion.
  • Announce the User Guide, Glossary, FAQ, and/or mini essays for wider review.

References:

1. ↑ http://colab.mpdl.mpg.de/mediawiki/CreatingMetadata
2. ↑ http://colab.mpdl.mpg.de/mediawiki/PublishingMetadata
3. ↑ http://colab.mpdl.mpg.de/mediawiki/UsingDC
4. ↑ http://dublincore.org/groups/userguide/2010/2010-10-21.dcuser-dcglossary-meeting.pdf
5. ↑ http://sites.google.com/site/dublincoreglossaryupdate/Home
6. ↑ http://dublincore.org/groups/userguide/
7. ↑ https://www.jiscmail.ac.uk/cgi-bin/webadmin?A2=DC-GLOSSARY;582e633c.1011

Meetings and telecons

• 2011-05-02: New wiki pages of the DCMI User Documentation Task Group announced to the list (superseding Glossary Task Group wiki).
• 2011-03-16: Progress report
• 2010-12-04. User Documentation Workplan.
• 2010-10-21: Face-to-face meeting in Pittsburgh Agenda, Meeting packet, Report
• 2010-05-07: Glossary/User Guide telecon - Agenda, report
• 2010-10-21: Glossary/User Guide telecon - Agenda
• 2010-08-30, DCMI User Guide Task Group established
  • Purpose: to prepare a revision of Diane Hillmann's "Using Dublin Core", which was first drafted in January 1998 and last revised in November 2005, as the user guide remains one of the most popular documents on the DCMI Web site, attesting to a strong user demand for such introductory materials.
• 2009-10-16: Discussion of Diane Hillmann's "Using Dublin Core" at a face-to-face meeting of the Usage Board at DC-2009 in Seoul.

Related links

• Mailing list of the User Documentation Task Group
• Diane Hillmann's "Using Dublin Core"
• Guidelines for the FOAF vocabulary
• Legacy Frequently Asked Questions - turn this into a redirect, or mark "superseded" and point to the wiki page?
• Legacy Glossary - turn this into a redirect to the wiki page?