DCMI User Documentation Task Group on DCMI

Fri, 01 Sep 2017 00:00:00 +0000

Meeting report - User Guide and Glossary Task Forces

2010-10-21, DC-2010, Pittsburgh

-- Agenda
http://dublincore.org/groups/userguide/2010/2010-10-21.dcglossary-dcuser-agenda.html
-- Meeting PDF
http://dublincore.org/groups/userguide/2010/2010-10-21.dcuser-dcglossary-meeting.pdf
-- Raw meeting notes:
http://dublincore.org/groups/userguide/2010/2010-10-21.dc-glossary-meeting-raw-notes.doc

Co-chairs: Mary Woodley, Tom Baker

Thanks to Mary for scribing!

The two taskforces have joined forces to synchronize the
development of the new edition of the user guide and a new and
streamlined glossary. They are also working on a new FAQ and
a series of essays which provide a historical perspective of
how terminology for metadata concepts has evolved has evolved
in the DC community. We have been working through email and
periodic phone/Skype conference calls.

One newcomer at the meeting, Steven Miller, signed up to
participate in the task groups.

Discussion focused on:

1. Updating the User Guide, refining the structure and organization
into a logical sequence and identifying parts that needed to
be updated.
2. Glossary of terms, significantly revamping the legacy glossary
a. Smaller scope to include only DC perspective only
b. Alignment with other DC documentation
3. Goals of next steps, gaps, version up on the list
4. Publication platform: it is always difficult and fiddly to convert
Wiki documents into HTML documents. On the wish-list: an updated
Wiki structure for publication platform.

----------------------------------------------------------------------
User Guide, "Using Dublin Core™"

http://colab.mpdl.mpg.de/mediawiki/UsingDC
http://colab.mpdl.mpg.de/mediawiki/CreatingMetadata
http://colab.mpdl.mpg.de/mediawiki/PublishingMetadata

Scope:
-- how to create a metadata description
-- how to publish the description as linked data

Identified need to clarify definitions for what constitutes a
metadata description in Linked Data.

-- UsingDC
Should move Section 5 (What is Dublin Core?) to position 3 (after What
is Metadata? and before What is Linked Data?)

Re: Dublin Core™ Properties: need simple paragraph of explanation, including
issue of namespaces (legacy vs dcterms)

Levels of interoperability section should focus on Levels 1 and 2 only,
though it should link to documentation about all levels.

Stefanie will update the font style to make the legend for the properties
more understandable

-- CreatingMetadata
This is about filling in the fields without necessarily knowing what is
under the hood.

-- PublishingMetadata
This is about what is under the hood (architecture) i.e. encoding in
the dcterms namespace.

Note Pete's change suggestions on page 44 of the meeting packet.

----------------------------------------------------------------------
Glossary - see meeting packet

We have the Glossary, on one hand, and ten mini topical
essays (one-pagers listing the history of concepts in the
DC concept) which can be used as the basis for glossary
entries and the user guide.

1. We should keep superseded terminology in the glossary, with very
brief definitions, and link to the mini-essays.
2. Add RDF terminology relevant to DC with links to RDF definitions
and to the mini essays.
3. Re: mini essay on "Dublin Core™": DCMES should have its own glossary
entry (pointing to the essay).
4. Re: mini essay on Dumb-down principle: use the first paragraph in
the glossary.
5. Re: Namespace Policy essay and Namespace essay: split this information
between the glossary and the user guide. Start the glossary entry with
what is a namespace.
6. Retain a definition of URI in the glossary, with brief definition,
pointing perhaps to Juha's recent overview [1].
7. One-to-one principle: keep. What constitutes a "resource" as a
meaningful object of description, lies in the eye of the beholder.
Link to mini essay.
8. Open World Mindset teaser for glossary - link to essay...
9. RDF essay: need to distill for glossary.
10. Resource discovery and Resource description essay: properties designed
for description or discovery; originally elements designed solely for
description were not included. Evolved to include more than just digital
objects but things that belong to the classes of the DCMI Type
Vocabulary. Not sure if this belongs to the glossary or user guide but
will be maintained as part of the overall background document.
11. Simple and Qualified Dublin Core™ - ok.

----------------------------------------------------------------------
FAQ

1. Do not want an exhaustive list.
2. Link dcterms to user guide document
3. Need to develop platform and anchors
4. Tom looked through answers posted to (now-defunct) AskDCMI service.
Simple questions on where to find things; quite a few questions
on syntax and encoding. Many of these are out of scope if DCMI is
de-emphasizing syntax guidelines.

[1] http://metadaten-twr.org/2010/10/13/persistent-identifiers-an-overview/

Fri, 01 Sep 2017 00:00:00 +0000

Glossary and User Guide Task Groups - face-to-face meeting

Date: 2010-10-21, Thursday, 14:00-15:30
In program: http://www.asis.org/Conferences/DC2010/program-sessions.html#userdoc
Expected: Tom, Mary, Stefanie, Marcia, Pete (remote)
Meeting PDF: http://dublincore.org/groups/userguide/2010/2010-10-21.dcuser-dcglossary-meeting.pdf

1. 14:00-14:30 - User Guide (Stefanie)

   Discuss (see meeting PDF)
   -- http://colab.mpdl.mpg.de/mediawiki/UsingDC
   -- http://colab.mpdl.mpg.de/mediawiki/CreatingMetadata
   -- http://colab.mpdl.mpg.de/mediawiki/PublishingMetadata
   -- Pete comments on User Guide

   Note: guidance on specific properties in the User Guide may be 
   discussed in the Libraries Task Group meeting on Wednesday, see
   http://www.asis.org/Conferences/DC2010/program-sessions.html#librarytaskgroup

2. 14:30-15:00 - Glossary and FAQ (Tom and Mary)

   Discuss glossary entries (see meeting PDF)
      DCMI Metadata Terms
      Dublin Core™
      Dumb-Down
      Namespace Policy
      One to One Principle
      Open World Mindset
      RDF
      Resource Discovery
      Simple Dublin Core™

   Discuss FAQ entries (see meeting PDF)
      On reusing XML elements

3. 15:00-15:30 - Issues and Next Steps

   General principles
   -- One list, with both current and obsolete technology.
   -- Legacy or archaic terminology can be marked as such.

   Issues
   -- Cross-references and redundancies among User Guide, Glossary, FAQ
   -- Form of publication (wiki document?)
   -- Next steps, work plan

Fri, 01 Sep 2017 00:00:00 +0000

Glossary and User Guide Task Groups - Telecon - Report
http://dublincore.org/groups/userguide/2010/2010-09-28.dcglossary-telecon-report.html

Tuesday, September 28, 2010
Attended: Tom, Mary, Stefanie, Marcia
Regrets: Pete

1. User Guide (Stefanie)

   http://colab.mpdl.mpg.de/mediawiki/UsingDC
   http://colab.mpdl.mpg.de/mediawiki/CreatingMetadata
   http://colab.mpdl.mpg.de/mediawiki/PublishingMetadata

   Stefanie wonders whether, given the focus on DCMI Metadata Terms and
   their use in Linked Data, it really is necessary to have a section on 
   concrete syntaxes (one of the topics covered in the User Guide). She
   will discuss with Pete.

   Tom wondered whether one might want to make the point
   somewhere early in CreatingMetadata that the data value one
   "enters" in the form, as a cataloger, is not necessarily
   what will go into data itself, nor is it necessarily what
   the end user will see presented on-screen. For example,
   a cataloger may enter a URI for a subject heading (perhaps
   via a pull-down menu of labels), and the user might only
   see the label of that heading. Stefanie will consider.

2. Glossary and FAQ

   Opinion on the call tended towards having one list which
   includes both current and obsolete technology. If they were
   divided into two lists, then people going to the glossary
   to look a term would not necessarily know in which list to
   look. Legacy or archaic terminology can be marked as such.

3. Agenda for Tuesday, 21 October, 14:00-15:30
   http://www.asis.org/Conferences/DC2010/program-sessions.html#userdoc

   14:00-14:30 User Guide
   14:30-15:00 Glossary and FAQ - entry by entry
   15:00-15:30 Other:
               -- Cross-references and redundancies among User Guide, Glossary, FAQ
               -- Form of publication (wiki document?)
               -- Next steps, work plan

   Tom proposes:
   -- Agenda to be posted on dc-glossary and http://dublincore.org/groups/userguide/
   -- By 13 October, all links on agenda copied into one PDF file and posted

   General concern that ninety minutes will not be enough for
   good, substantive discussion. Mary and Stefanie happen also
   to be the organizers of a Libraries Task Group meeting all
   day on Wednesday [1]. Discussion of User Guide examples,
   property by property, would arguably fall into the scope
   of that meeting, so we could use the Tuesday meeting more
   for Glossary, FAQ, and introductory sections of the User
   Guide -- and more generally for planning the finalization,
   review, and publication of the documents.

   The alternative would be to try to squeeze in more meeting
   time on Tuesday -- e.g., a working lunch from 12:30 to
   13:30 or after the final session, 17:00-18:00.

   Everyone on the call agreed to Tom's suggestion to continue
   discussion on the dc-glossary list. Tom will compile a
   PDF meeting packet on Wednesday, 13 October, including
   all of the texts to be discussed.

   [1] http://www.asis.org/Conferences/DC2010/program-sessions.html#librarytaskgroup

Fri, 01 Sep 2017 00:00:00 +0000

Glossary and User Guide Task Groups - Telecon - Agenda
http://dublincore.org/groups/userguide/2010/2010-09-28.dcglossary-telecon-agenda.html

    Date: Tuesday, September 28, 2010
    Start Time: 12:00 PM Eastern Daylight Time
    Dial-in Number: +1-218-936-4141 (Midwest)    
    Participant Access Code 334034

Expected: Tom, Mary, Stefanie, Marcia
Regrets: Pete

1. User Guide (Stefanie)

   http://colab.mpdl.mpg.de/mediawiki/UsingDC
   http://colab.mpdl.mpg.de/mediawiki/CreatingMetadata
   http://colab.mpdl.mpg.de/mediawiki/PublishingMetadata

   Questions for discussion:

   -- Is the document structured well for expert and non-expert users?
   -- Should this document be published and maintained in a (MediaWiki) wiki?

2. Glossary and FAQ

   -- FAQ answer about "reusing" XML elements
      https://www.jiscmail.ac.uk/cgi-bin/webadmin?A2=ind1009&L=DC-GLOSSARY&P=4021
   
   -- Dumb-Down Principle
      https://www.jiscmail.ac.uk/cgi-bin/webadmin?A2=ind1009&L=DC-GLOSSARY&P=18366
   
   -- Namespace, DCMI Namespace, DCMI Namespace Policy
      https://www.jiscmail.ac.uk/cgi-bin/webadmin?A2=ind1009&L=DC-GLOSSARY&P=6753
   
   -- Resource Discovery, Resource Description
      https://www.jiscmail.ac.uk/cgi-bin/webadmin?A2=ind1009&L=DC-GLOSSARY&P=5924
   
   -- Simple Dublin Core™
      https://www.jiscmail.ac.uk/cgi-bin/webadmin?A2=ind1009&L=DC-GLOSSARY&P=5209
   
   -- Terms, DCMI Metadata Terms
      https://www.jiscmail.ac.uk/cgi-bin/webadmin?A2=ind1009&L=DC-GLOSSARY&P=4612
   
   -- One-to-One Principle
      https://www.jiscmail.ac.uk/cgi-bin/webadmin?A2=ind1009&L=DC-GLOSSARY&P=20055
   
   -- "Dublin Core™ Metadata Initiative"
      https://www.jiscmail.ac.uk/cgi-bin/webadmin?A2=DC-GLOSSARY;e14dfa82.1009

   In the pipeline:
   -- DCMI Abstract Model
   -- Metadata Enrichment
   -- Interoperability
   -- Linked Data
   -- Literal Values
   -- Open World Mindset
   -- RDF
   -- FAQ: Difference between /elements/1.1/ and /terms/ properties
   -- FAQ: DC in OWL
   -- FAQ: What if my needs are [simpler / more complex]?
   -- FAQ: Roles?

3. Agenda for Tuesday, 21 October, 14:00-15:30
   http://www.asis.org/Conferences/DC2010/program-sessions.html#userdoc

   14:00-14:30 User Guide
   14:30-15:00 Glossary and FAQ - entry by entry
   15:00-15:30 Other:
               -- Cross-references and redundancies among User Guide, Glossary, FAQ
               -- Form of publication (wiki document?)
               -- Next steps, work plan

   Tom proposes:
   -- Agenda to be posted on dc-glossary and http://dublincore.org/groups/userguide/
   -- By 13 October, all links on agenda copied into one PDF file and posted

Fri, 01 Sep 2017 00:00:00 +0000

Notes from a Skype call, 2010-05-07

Mary: We're starting by taking things out of the current
Glossary. Question: how should be denote legacy terms?
Should we keep them in one list, marked as legacy, or split
them into a separate list?

People working with Level 1 software - are most people.
We need to continue to support those people. New people
coming in still using this. Alot of people we teach are not
catalogers - they are administrators.

Steffi: Simple/Qualified DC?

Mary: Change in terminology, but not dropping support. When I
teach it, this is the original terminology. My question:
take another step back: originally we had all metadata terms
in the glossary (title, date...).

Steffi: We should keep them out of glossary.

Marcia: Agree with Mary - from my teaching, vast majority
still in Level 1. They see how to turn bibliographic into
linked data. From library community: first vocabularies become
linked data, then bibliographic data (Swedish, Hungarian).
Bridge is Dublin Core™. Getty - historical or current.
Indicators can be used.

Don't like "legacy" for things that are still valid,
only older. Implies they are no longer valid. "Historical"
doesn't have the same negative connotation as "legacy".
Or "classic", as in classic / semantic.

Steffi: Local/global is not good.

Mary: We want people to think about what their metadata will
look like outside their context.

Mary: Classic / Semantic / Legacy (warwick, lego).

Tom: "Dublin Core™ style".

Steffi: "Using DC Version 2"? Tell what they will read
and why - didn't change much. Changes in Chaps 1 ("What is
metadata?") and 2 ("What is DC?")

Mary: Software designers need to understand triples.
Others just need to input metadata - add VES, etc - and we
confuse them.

Marcia: "Record" - really talking about Descriptions. What is
the basic unit - Description? Record?

Links: 
-- http://www.jiscmail.ac.uk/dc-glossary - mailing list
-- http://sites.google.com/site/dublincoreglossaryupdate/ - wiki 
-- https://www.jiscmail.ac.uk/cgi-bin/webadmin?A2=ind1004&L=dc-glossary&P=54 - charter
-- http://dublincore.org/documents/2005/11/07/usageguide/glossary/ - 2005 glossary
-- http://library.csun.edu/mwoodley/DublinCore/glossary.shtml - changes proposed by Mary
-- http://dublincore.org/groups/tools/glossary/ - 2007 dc-tools glossary
-- http://dublincore.org/usageboardwiki/UsingDublinCore - Steffi's revision of Using DC
-- http://dublincore.org/usageboardwiki/UsingDublinCore_2fChapterOne 
-- http://dublincore.org/usageboardwiki/UsingDublinCore_2fChapterTwo 
-- http://dublincore.org/usageboardwiki/UsingDublinCore_2fChapterThree 
 
-- 
Thomas Baker <tbaker@tbaker.de>

Fri, 01 Sep 2017 00:00:00 +0000

DCMI Glossary Task Force - telecon - Friday, 2010-05-07

Expected:
    Mary Woodley, co-chair
    Tom Baker, co-chair
    Marcia Zeng
    Stefanie Ruehle

----------------------------------------------------------------------
Links:
-- DC-GLOSSARY mailing list
   http://www.jiscmail.ac.uk/dc-glossary

-- DC-GLOSSARY wiki (contact Mary Woodley <mary.woodley@gmail.com> for access)
   http://sites.google.com/site/dublincoreglossaryupdate/

-- DC-GLOSSARY charter
   https://www.jiscmail.ac.uk/cgi-bin/webadmin?A2=ind1004&L=DC-GLOSSARY&P=54

-- Existing DCMI Glossary, last published 2005 (part of User Guide)
   http://dublincore.org/documents/2005/11/07/usageguide/glossary/

-- Existing DCMI Glossary showing Mary's proposed changes (deletions)
   http://library.csun.edu/mwoodley/DublinCore/glossary.shtml

Other glossaries:
-- DCMI Tools Glossary (2007 draft)
   http://dublincore.org/groups/tools/glossary/ 

----------------------------------------------------------------------
1) Review of charter (see attached)

2) 2010-03-03 telecon - Tom and Mary

   -- Rather than aspiring to be a comprehensive glossary that one 
      would consult upon coming across an unfamiliar term, we picture
      the glossary more as a short document, and therefore maintainable,
      written in an engaging style -- a sort of general introductory 
      document one might assign for a metadata class or print off for 
      reading on the train. We are therefore inclined to keep the number
      of entries small. For a sense of what the glossary might look like
      as a Web page, see [1].
   
   -- One of the problems the glossary should address is
      confusion over terminology, which has significantly evolved
      over the years, from "elements and qualifiers" through
      "encoding schemes" to "properties and datatypes", with historically
      interesting concepts along the way, such as "dumb-down principle".
      Rather than throw away the old concepts, we agreed to work for now
      with two files -- one (smaller) list of concepts in current use, and
      a somewhat longer list of legacy concepts. This picks up on a suggestion
      made in the Seoul Usage Board meeting by Joe Tennis [2]. Whether the
      legacy and current concepts would be listed in separate documents, 
      interleaved but clearly marked in one document, or combined in one
      document with clearly marked Current and Legacy sections, is a 
      question that for now can be postponed.

    [1] http://dublincore.org/specifications/dublin-core/glossary/
    [2] http://dublincore.org/usage/minutes/2009/2009-10-16.dcub-meeting-seoul-minutes.html

3) Stefanie's revision of Using Dublin Core™
   http://dublincore.org/usageboardwiki/UsingDublinCore
   http://dublincore.org/usageboardwiki/UsingDublinCore_2fChapterOne
   http://dublincore.org/usageboardwiki/UsingDublinCore_2fChapterTwo
   http://dublincore.org/usageboardwiki/UsingDublinCore_2fChapterThree

4) Scope of glossary

-- DC-GLOSSARY wiki (contact Mary Woodley <mary.woodley@gmail.com> for access)
   http://sites.google.com/site/dublincoreglossaryupdate/

-- Existing DCMI Glossary showing Mary's proposed changes (deletions)
   http://library.csun.edu/mwoodley/DublinCore/glossary.shtml

5) Next steps

======================================================================
Appendix

DCMI Glossary Task Force (2010-03-04)

Co-chairs: Mary Woodley and Tom Baker

Purpose

    The DCMI Glossary was last updated as part of "Using Dublin
    Core" in November 2005 [1]. The 2005 glossary provided
    definitions and links to further information for 204
    glossary terms. In scope were concepts of relevance to
    "metadata" in a broad sense; an appendix included short
    descriptions of eleven other metadata standards related to
    Dublin Core™.

    The Glossary Task Force co-chairs propose to write an
    entirely new glossary - one that is much shorter and focused
    on concepts characteristic of or unique to DCMI usage.
    Rather than consider the glossary as a place primarily to
    "look up" concepts encountered elsewhere, the co-chairs
    envision the glossary as a short and engaging text that
    should be readable in its own right as an introduction to 
    Dublin-Core-style metadata -- one written to fit the 
    new reading styles of an online audience [4].

Work Plan

    Mary has reviewed the 2005 glossary and is preparing a list
    of the (relatively few) concepts that are candidates for carrying
    forward from the old glossary into the new [5]. Tom is
    preparing a list of more recent concepts to add to this
    shortlist. We plan to post this list to the dc-glossary
    list [2] and post an invitation to dc-general to participate
    in discussion.

    In light of its didactic nature, the editors see the
    glossary as an opportunity to coin new handles that capture
    and elucidate distinctions between "legacy" DCMI approaches
    and the current "semantic" or "linked-data" orientation.
    The editors therefore believe the glossary could serve as a
    useful focus for discussions in the DCMI community (Advisory
    Board, Oversight Committee, Usage Board, and general mailing
    lists) on clarifying DCMI's general message.

    Work on the glossary will proceed on a Dublin Core™ Glossary
    Update wiki [3].

Schedule

    April: Post a shortlist of proposed glossary terms to the
    dc-glossary (and possibly dc-general), inviting suggestions
    and discussion.

    May: Prepare a draft to circulate for comment by the DCMI 
    community (Usage Board, Advisory Board, Oversight Committee,
    and the general public).

    June: Finalize a stable draft before the
    (Northern-hemisphere) summer season. Submit for Usage Board
    review.

    October: Discuss the draft Glossary at DC-2010 with
    interested parties, such as the DCMI Advisory Board and
    Usage Board for finalization as a DCMI Recommended Resource.

[1] http://dublincore.org/documents/2005/11/07/usageguide/glossary/
[2] http://www.jiscmail.ac.uk/dc-glossary
[3] http://sites.google.com/site/dublincoreglossaryupdate/
[4] http://www.useit.com/alertbox/9710a.html
[5] http://library.csun.edu/mwoodley/DublinCore/glossary.shtml

-- 
Thomas Baker <tbaker@tbaker.de>