Difference between revisions of "Category:Documentation Cluster"

From Earth Science Information Partners (ESIP)
 
(123 intermediate revisions by 7 users not shown)
Line 1: Line 1:
[[File:MetadataInMultipleDialects.png|thumb|Metadata Dialects]]“''We dissect nature along lines laid down by our native language. Language is not simply a reporting device for experience but a defining framework for it.''” Benjamin Lee Whorf
+
__NOTOC__
 +
<center><big>'''Welcome to the Documentation Cluster'''</big></center>''Note: The Documentation Cluster is on hiatus, which is a period of inactivity a cluster may enter once its goals have been achieved. You will still likely find sessions covering this topic at ESIP Meetings and many documentation enthusiasts in the community. If you would like to discuss re-activating the Documentation Cluster to achieve new goals, please contact staff@esipfed.org. You can also still contact the Documentation Cluster Mailing List at esip-documentation@lists.esipfed.org.''<center>Chair: Ted Habermann, [https://www.tedhabermann.com Metadata Game Changers]</center>
 +
<center>2018 Theme: <font color="green">'''Promoting documentation techniques to articulate and measure the socioeconomic value and benefit of Earth science data, information and applications. '''</font></center>
  
 +
=====ESIP Vision=====
 +
[[File:MetadataInMultipleDialects.png|thumb|Figure 1|left]]“''We dissect nature along lines laid down by our native language. Language is not simply a reporting device for experience but a defining framework for it.''” Benjamin Lee Whorf
 +
 +
=====About Us=====
 +
While Eskimos (and people that live in Colorado) have many words for what others call snow, and surfers have many words for what others call waves, ESIP members have many words for documentation. The goal of the Documentation Cluster is to improve understanding, utilization and integration of all of the dialects shown in Figure 1 and others used in the global environmental community. Equally important, we will work in the spaces between these dialects to build understanding from the similarities and differences between them.
 +
 +
A dialect is a "variety of a language that is a characteristic of a particular group". In the context of data sharing in ESIP, the ways that different groups document their data and products (i.e. metadata standards) are great examples of dialects. They are varieties of the over-arching language of documentation that are used by particular groups in ESIP and other partners in the global environmental community. Figure 1 illustrates this idea with a few commonly used dialects.
  
 
The ESIP Community is made up of scientists and informatics experts from a wide variety of disciplines and backgrounds. They come together at ESIP because they realize that they share common needs and hope that they can find others that can help them address those needs. For example, many ESIP members make observations and process them into datasets and products or run models that "predict" data in the past, present, or future. We all want to share those products with a variety of users and, more importantly, we want to make sure those users can discover, use, and understand those products.
 
The ESIP Community is made up of scientists and informatics experts from a wide variety of disciplines and backgrounds. They come together at ESIP because they realize that they share common needs and hope that they can find others that can help them address those needs. For example, many ESIP members make observations and process them into datasets and products or run models that "predict" data in the past, present, or future. We all want to share those products with a variety of users and, more importantly, we want to make sure those users can discover, use, and understand those products.
  
A dialect is a "variety of a language that is a characteristic of a particular group". In the context of data sharing in ESIP, the ways that different groups document their data and products (i.e. metadata standards) are great examples of dialects. They are varieties of the over-arching language of documentation that are used by particular groups in ESIP and other partners in the global environmental community. The Figure on the right illustrates this idea with a few commonly used dialects.
+
The Documentation Cluster is an evolution of the original CF Cluster that was started by Rob Raskin and focused on the Climate-Forecast Conventions that are: commonly used by netCDF and related tools. The CF Conventions are an important metadata dialect used by a number of ESIP members and their partners. The Documentation Cluster helps us keep in mind that the CF Conventions are only one of many dialects used by different ESIP groups.
 +
 
 +
{| width="100%" cellpadding="0" cellspacing="0" style="zborder-top:1px solid #aaaaaa; border-collapse: collapse;"
 +
|- valign="top" bgcolor="#FFFFFF"
 +
| bgcolor="lightgreen" style="border: 1px solid gray;padding-left:0.5em;padding-right:0.5em;" width="50%" |
 +
 
 +
==Events==
 +
'''Meeting Agenda and Notes for 2019 - 2020'''
 +
https://docs.google.com/document/d/10uKdmshYuOP15f5CBc5qXNcu7GrfoQwnKnsLpvU8ar0/edit
 +
'''Meeting Agenda and Notes for 2018'''
 +
 
 +
*Completed:
 +
 
 +
:*Winter 2018 Meeting in Bethesda
 +
 
 +
[https://2018esipwintermeeting.sched.com/event/D6Da/metadata-carpentry-whats-in-your-toolbelt Metadata Carpentry]
 +
[https://2018esipwintermeeting.sched.com/event/D6DZ/granule-metadata-experiences Granule Metadata Experiences]
 +
[https://2018esipwintermeeting.sched.com/event/D6DY/shared-vocabularies-facilitate-data-use Shared Vocabularies Facilitate Data Use]
 +
 
 +
*Upcoming
  
The Documentation Cluster is in the process of emerging from the CF Cluster that was started by Rob Raskin and focused on the Climate-Forecast Conventions that are commonly used by netCDF and related tools. The CF Conventions are an important metadata dialect used by a number of ESIP members and their partners. At the same time, evolving the CF Cluster into the Documentation Cluster helps us keep in mind that the CF Conventions are only one of many dialects used by different ESIP groups.
+
:*Feb 26 ESIPhub. A Jupyter based collaborative platform to facilitate workshops at ESIP Meetings. What kind of documentation does it need?
 +
:*March-TBD
 +
:*April-TBD
 +
:*May-TBD
 +
:*June-TBD
 +
:*July-Summer Meeting 2018
 +
:*August- CEDAR
 +
:*September- ACDD Roundtable [https://docs.google.com/document/d/12yFwzk0wqvLyk4y7NVM7N4BR8Pz4245IwpgEnW9pcCc/edit?usp=sharing Minutes]
 +
:*October- Proposals for Winter Meeting 2019 Roundtable[https://docs.google.com/document/d/14wUotDaZotveZwSJboUBMsKAQzXXZU_j-o2sVfVcKVc/edit Minutes]
 +
:*November - Jeff Campbell Lessons learned implementing ISO 19115-3 for the USDA using GeoNetwork, an open source geospatial catalog software. [[File:USDA_NAL_GeoData_Jeff_Campbell_2018-11-26.pptx]]
  
While Eskimos (and people that live in Colorado) have many words for what others call snow, and surfers have many words for what others call waves, ESIP members have many words for documentation. The goal of the Documentation Cluster is to improve understanding, utilization and integration of all of the dialects shown in this Figure and others used in the global environmental community. Equally important, we will work in the spaces between these dialects to build understanding from the similarities and differences between them.
+
'''Meeting Agenda and Notes for 2017'''
  
The group is co-chaired by Ted Habermann, HDF and Ed Armstrong, JPL and welcomes participation of all ESIP members.
+
*Completed:
  
==Email List==
+
:*Jan 23
Join the '''[http://lists.esipfed.org/mailman/listinfo/esip-documentation list]''' for this group to receive meeting notifications and other information. To send to the list, email: esip-documentation@lists.esipfed.org
+
:*View [https://youtu.be/drcvrmi3wVc Recording]
 +
:*View [[Documentation Cluster Minutes 2017-01-23|Minutes]]
 +
:*Feb 27
 +
:*Recording failed
 +
:*View [[Documentation Cluster Minutes 2017-02-27|Minutes]]
 +
:*March 27
 +
:*[https://youtu.be/1y6wB1rUVVs Recording]
 +
:*View [[Documentation Cluster Minutes 2017-03-27|Minutes]]
 +
:*April 24
 +
:*[https://youtu.be/J9CpjtEVwwU Recording]
 +
:*View [[Documentation Cluster Minutes 2017-04-24|Minutes]]
 +
:*June 26
 +
:*[https://youtu.be/2vTTo1ExJBE Recording]
 +
:*October 23
 +
:*[https://youtu.be/JJR2XVzJhfY Recording]
 +
:*View [https://docs.google.com/document/d/18XkaFNRK7PHdUbbT2-KM84w63SkMe9svne11B2BUmIA/edit?usp=sharing Proposals]
 +
:*November 28
 +
:*View [https://docs.google.com/document/d/18XkaFNRK7PHdUbbT2-KM84w63SkMe9svne11B2BUmIA/edit?usp=sharing Session Two sections c and d]
  
==Next Teleconference==
+
*Upcoming:
Wednesday, November 20, 2013 at noon EDT. <br>
 
Agenda [http://commons.esipfed.org/node/1762 link to commons]<br>
 
*January meeting topics
 
  
-----------------------------------------------------------------------------------------------
 
To join the online portion of the meeting:
 
https://esipfed.webex.com/mw0306ld/mywebex/default.do?siteurl=esipfed&service=1
 
  
Meeting Password: 23138379
+
'''Telecon Instructions:'''
  
-----------------------------------------------------------------------------------------------
+
:No monthly telecons are currently being held.
Call-in toll-free number (US/Canada): 1-877-668-4493
+
::
Attendee access code: 23138379
 
  
==Meeting Minutes==
+
'''Previous Meeting Agendas and Notes:'''
September 2013 Telecon
 
[[File:September_2013_Documentation_Telecon.docx]]<br>
 
[https://esipfed.webex.com/esipfed/ldr.php?AT=pb&SP=MC&rID=70802757&rKey=3f3d0215aa6b20d0 Meeting Recording (Streaming)] <br>
 
[https://esipfed.webex.com/esipfed/lsr.php?AT=dw&SP=MC&rID=70802757&rKey=8603263bf0c73384  Meeting Recording (Download)] <br>
 
[http://commons.esipfed.org/node/1711 link to notes on commons]<br>
 
  
July 2013 Telecon
+
*[[Documentation_Cluster_Meeting_Minutes]]
[[File:July_2013_Documentation_Telecon.docx‎]]<br>
+
| bgcolor="#FFFFBB" style="border: 1px solid gray;padding-left:0.5em;padding-right:0.5em;" width="50%" |
[https://esipfed.webex.com/esipfed/ldr.php?AT=pb&SP=MC&rID=69100652&rKey=d71045ca2da06e02 Meeting Recording (Streaming)] <br>
 
[https://esipfed.webex.com/esipfed/lsr.php?AT=dw&SP=MC&rID=69100652&rKey=12bdca17e2495a04 Meeting Recording (Download)] <br>
 
[http://commons.esipfed.org/node/1710 link to notes on commons] <br>
 
  
Summer ESIP meeting<br>
+
==Get Involved==
1) ACDD - Thursday July 11 13:30 - 15:00 - [http://commons.esipfed.org/node/1501 commons link] <br>
 
2) Community Adoption: Lessons Learned - Thursday July 11 10:30 - 12:00 - [http://commons.esipfed.org/node/1500 commons link]<br>
 
  
May Telecon<br>
+
:
No word document notes file for this month (see notes on commons below) <br>
 
[https://esipfed.webex.com/esipfed/ldr.php?AT=pb&SP=MC&rID=67487087&rKey=b7490192669a4368 Meeting Recording (Streaming)] <br>
 
[https://esipfed.webex.com/esipfed/lsr.php?AT=dw&SP=MC&rID=67487087&rKey=9c341e6e2d408221 Meeting Recording (Download)] <br>
 
[http://commons.esipfed.org/node/1488 link to notes on commons] <br>
 
  
April Telecon <br>
+
*'''Share!'''
[[File:Documentation_Cluster_April_2013.docx‎‎]] <br>
 
[https://esipfed.webex.com/esipfed/ldr.php?AT=pb&SP=MC&rID=66738367&rKey=38f1a4e0c983789f Meeting Recording (Streaming)] <br>
 
[https://esipfed.webex.com/esipfed/lsr.php?AT=dw&SP=MC&rID=66738367&rKey=1ab1c739fb42da97 Meeting Recording (Download)] <br>
 
[http://commons.esipfed.org/node/1457 link to notes on commons] <br>
 
  
March Telecon <br>
+
:*We want to know about your documentation ideas, solutions and challenges via the mailing list.
[[File:Documentation_Cluster_March_2013.docx‎]] <br>
 
[https://esipfed.webex.com/esipfed/ldr.php?AT=pb&SP=MC&rID=66053937&rKey=482e48b7afab0f8a Meeting Recording (Streaming)] <br>
 
[https://esipfed.webex.com/esipfed/lsr.php?AT=dw&SP=MC&rID=66053937&rKey=7c918be321afb485 Meeting Recording (Download)] <br>
 
[http://commons.esipfed.org/node/1429 link to notes on commons] <br>
 
  
February Telecon <br>
+
*'''Monthly Meeting'''
[[File:February_Documentation_Telecon_2013.docx]] <br>
 
[https://esipfed.webex.com/esipfed/ldr.php?AT=pb&SP=MC&rID=65359032&rKey=dd676e6ad86fc467 Meeting Recording (Streaming)] <br>
 
[https://esipfed.webex.com/esipfed/lsr.php?AT=dw&SP=MC&rID=65359032&rKey=739120ceac688c81 Meeting Recording (Download)] <br>
 
[http://commons.esipfed.org/node/1417 link to notes on common]] <br>
 
  
Winter Meeting (Jan 2013) <br>
+
:*No monthly meetings are being held at this time
[[File:CFUnleashed.docx‎]]<br>
 
[[IsoLand.docx‎]] <br>
 
[http://commons.esipfed.org/node/681 CF Unleashed on commons] <br>
 
[http://commons.esipfed.org/node/682 New Developments in IsoLand on commons] <br>
 
  
December Telecon <br>
+
*'''Email List'''
[[File:December_Documentation_Telecon_2012.docx‎]] <br>
 
[https://esipfed.webex.com/esipfed/ldr.php?AT=pb&SP=MC&rID=64079152&rKey=ee25aed3a5d568b2  Meeting Recording (Streaming)] <br>
 
[https://esipfed.webex.com/esipfed/lsr.php?AT=dw&SP=MC&rID=64079152&rKey=6106722fd685b801 Meeting Recording (Download)] <br>
 
[http://commons.esipfed.org/node/725 link to notes on commons] <br>
 
  
November Telecon <br>
+
:*Send Email to Group: [mailto:esip-documentation@lists.esipfed.org esip-documentation@lists.esipfed.org]
[[File:November_Documentation_Telecon_2012.docx‎]] <br>
+
:*Join Email List: [http://lists.esipfed.org/mailman/listinfo/esip-documentation ESIP Documentation]
[https://esipfed.webex.com/esipfed/ldr.php?AT=pb&SP=MC&rID=63158432&rKey=b18256c292dc2334  Meeting Recording (Streaming)] <br>
+
:*View Email Archive: [http://lists.esipfed.org/pipermail/listinfo/esip-documentation/ ESIP Documentation Email Archive]
[http://https://esipfed.webex.com/esipfed/lsr.php?AT=dw&SP=MC&rID=63158432&rKey=9477eb55fc27c429 Meeting Recording (Download)] <br>
+
|}
[http://commons.esipfed.org/node/672 link to notes on commons] <br>
 
  
October Telecon <br>
+
{| width="100%" cellpadding="0" cellspacing="0" style="zborder-top:1px solid #aaaaaa; border-collapse: collapse;"
[[File:October_Documentation_Telecon_2012.docx]] <br>
+
|- valign="top" bgcolor="pink"
[https://esipfed.webex.com/esipfed/ldr.php?AT=pb&SP=MC&rID=62671632&rKey=0140b982ec591c98 Meeting Recording (Streaming)] <br>
+
| bgcolor="lightblue" style="border: 1px solid gray;padding-left:0.5em;padding-right:0.5em;" width="50%" |
[https://esipfed.webex.com/esipfed/lsr.php?AT=dw&SP=MC&rID=62671632&rKey=978fc3ac2b7b82af Meeting Recording (Download)] <br>
 
[http://commons.esipfed.org/node/650 link to notes on commons]] <br>
 
  
September Telecon <br>
+
==Activities==
[[File:September_Documentation_Telecon_2012.docx‎]] <br>
 
[https://esipfed.webex.com/esipfed/ldr.php?AT=pb&SP=MC&rID=62018437&rKey=616f6baf029a8a83 Meeting Recording (Streaming)] <br>
 
[https://esipfed.webex.com/esipfed/lsr.php?AT=dw&SP=MC&rID=62018437&rKey=b11858bb265975b3 Meeting Recording (Download)] <br>
 
[http://commons.esipfed.org/node/649 notes on commons] <br>
 
  
August Telecon <br>
+
*[[Attribute_Convention_for_Data_Discovery_1-3| Attribute Convention for Data Discovery 1-3]]
[[File:August_Documentation_Telecon.docx‎]] <br>
+
*[[ESIP Recommendations for FAIR Metadata| ESIP Recommendations for FAIR Metadata]]
[https://esipfed.webex.com/esipfed/ldr.php?AT=pb&SP=MC&rID=61254882&rKey=a9ff5111fde59ae3 Meeting Recording(streaming)] <br>
+
| bgcolor="pink" style="border: 1px solid gray;padding-left:0.5em;padding-right:0.5em;" width="50%" |
[https://esipfed.webex.com/esipfed/lsr.php?AT=dw&SP=MC&rID=61254882&rKey=96b456be6835508c Meeting Recording(download)] <br>
 
[http://commons.esipfed.org/node/641 notes on commons] <br>
 
  
July Telecon <br>
+
==Related Activities (and Other Stuff)==
[[File:Documentation_Cluster_July_2012_Meeting.docx‎]] <br>
+
see pages below with tagged with Documentation Cluster Category.
[https://esipfed.webex.com/esipfed/ldr.php?AT=pb&SP=MC&rID=60506572&rKey=cc863b0764781a9d Meeting Recording] <br>
+
|}
[http://commons.esipfed.org/node/610 notes on commons] <br>
 
  
Summer meeting 2012 - Documenting Data in Multiple Dialects <br>
+
[[category:Documentation]]
[http://commons.esipfed.org/node/450 Summary, notes, and recordings] <br>
 

Latest revision as of 14:45, March 30, 2021

Welcome to the Documentation Cluster

Note: The Documentation Cluster is on hiatus, which is a period of inactivity a cluster may enter once its goals have been achieved. You will still likely find sessions covering this topic at ESIP Meetings and many documentation enthusiasts in the community. If you would like to discuss re-activating the Documentation Cluster to achieve new goals, please contact staff@esipfed.org. You can also still contact the Documentation Cluster Mailing List at esip-documentation@lists.esipfed.org.

Chair: Ted Habermann, Metadata Game Changers
2018 Theme: Promoting documentation techniques to articulate and measure the socioeconomic value and benefit of Earth science data, information and applications.
ESIP Vision
Figure 1

We dissect nature along lines laid down by our native language. Language is not simply a reporting device for experience but a defining framework for it.” Benjamin Lee Whorf

About Us

While Eskimos (and people that live in Colorado) have many words for what others call snow, and surfers have many words for what others call waves, ESIP members have many words for documentation. The goal of the Documentation Cluster is to improve understanding, utilization and integration of all of the dialects shown in Figure 1 and others used in the global environmental community. Equally important, we will work in the spaces between these dialects to build understanding from the similarities and differences between them.

A dialect is a "variety of a language that is a characteristic of a particular group". In the context of data sharing in ESIP, the ways that different groups document their data and products (i.e. metadata standards) are great examples of dialects. They are varieties of the over-arching language of documentation that are used by particular groups in ESIP and other partners in the global environmental community. Figure 1 illustrates this idea with a few commonly used dialects.

The ESIP Community is made up of scientists and informatics experts from a wide variety of disciplines and backgrounds. They come together at ESIP because they realize that they share common needs and hope that they can find others that can help them address those needs. For example, many ESIP members make observations and process them into datasets and products or run models that "predict" data in the past, present, or future. We all want to share those products with a variety of users and, more importantly, we want to make sure those users can discover, use, and understand those products.

The Documentation Cluster is an evolution of the original CF Cluster that was started by Rob Raskin and focused on the Climate-Forecast Conventions that are: commonly used by netCDF and related tools. The CF Conventions are an important metadata dialect used by a number of ESIP members and their partners. The Documentation Cluster helps us keep in mind that the CF Conventions are only one of many dialects used by different ESIP groups.

Events

Meeting Agenda and Notes for 2019 - 2020 https://docs.google.com/document/d/10uKdmshYuOP15f5CBc5qXNcu7GrfoQwnKnsLpvU8ar0/edit Meeting Agenda and Notes for 2018

  • Completed:
  • Winter 2018 Meeting in Bethesda

Metadata Carpentry Granule Metadata Experiences Shared Vocabularies Facilitate Data Use

  • Upcoming
  • Feb 26 ESIPhub. A Jupyter based collaborative platform to facilitate workshops at ESIP Meetings. What kind of documentation does it need?
  • March-TBD
  • April-TBD
  • May-TBD
  • June-TBD
  • July-Summer Meeting 2018
  • August- CEDAR
  • September- ACDD Roundtable Minutes
  • October- Proposals for Winter Meeting 2019 RoundtableMinutes
  • November - Jeff Campbell Lessons learned implementing ISO 19115-3 for the USDA using GeoNetwork, an open source geospatial catalog software. File:USDA NAL GeoData Jeff Campbell 2018-11-26.pptx

Meeting Agenda and Notes for 2017

  • Completed:
  • Upcoming:


Telecon Instructions:

No monthly telecons are currently being held.

Previous Meeting Agendas and Notes:

Get Involved

  • Share!
  • We want to know about your documentation ideas, solutions and challenges via the mailing list.
  • Monthly Meeting
  • No monthly meetings are being held at this time
  • Email List

Activities

Related Activities (and Other Stuff)

see pages below with tagged with Documentation Cluster Category.

Subcategories

This category has the following 6 subcategories, out of 6 total.

Media in category "Documentation Cluster"

This category contains only the following file.