Difference between revisions of "Category:Documentation Cluster"

From Earth Science Information Partners (ESIP)
 
(42 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
<center><big>'''Welcome to the Documentation Cluster'''</big></center>
+
<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> Co-Chairs: Ted Habermann, HDF Group and Anna Milan, NOAA </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>
<center>2016 Theme: <font color="green">'''Engaging Stakeholders in the Documentation Process'''</font></center>
 
  
===== ESIP Vision =====
+
=====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
 
[[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
  
Line 14: Line 13:
 
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.
  
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.
+
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;"  
 
{| width="100%" cellpadding="0" cellspacing="0" style="zborder-top:1px solid #aaaaaa; border-collapse: collapse;"  
 
|- valign="top" bgcolor="#FFFFFF"
 
|- valign="top" bgcolor="#FFFFFF"
|bgcolor="lightgreen" style="border: 1px solid gray;padding-left:0.5em;padding-right:0.5em;" width="50%"|
+
| bgcolor="lightgreen" style="border: 1px solid gray;padding-left:0.5em;padding-right:0.5em;" width="50%" |
  
 
==Events==
 
==Events==
'''Meeting Agenda and Notes for 2016'''
+
'''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
 +
 
 +
:*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]]
 +
 
 +
'''Meeting Agenda and Notes for 2017'''
 +
 
 +
*Completed:
 +
 
 +
:*Jan 23
 +
:*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]
 +
 
 
*Upcoming:
 
*Upcoming:
:*Mar 28
+
 
:** Presentation: Metadata Principles - Matt Mayernik (UCAR)
 
:** View [[Documentation Cluster Minutes 2016-03-28|Minutes]]
 
:*April 25
 
:** Presentation (potentially): QA viewer for validating DIFs and ECHO metadata records in CMR - Tyler Stevens (NASA/GCMD)
 
:*May 23- TBA
 
:*June 27
 
:**Presentation - Bob Hanisch (NIST)
 
:*July - summer meeting
 
:*Aug 22- Presentation: NCEAS, Matt Jones
 
:*Sept 26- TBA
 
:*Oct 24- TBA
 
:*Nov 28- TBA
 
:*Dec TBD - TBA
 
*Completed:
 
:*Jan 20
 
:* Feb 22nd
 
:** View [[Documentation Cluster Minutes 2016-02-22|Minutes]]
 
  
 
'''Telecon Instructions:'''
 
'''Telecon Instructions:'''
:To join the meeting from your computer, tablet or smartphone, click:
+
 
::https://www.gotomeeting.com/join/938671381
+
:No monthly telecons are currently being held.
:You can also dial in using your phone.
+
::
::United States: +1 (646) 749-3131
 
::Access Code: 938-671-381
 
  
 
'''Previous Meeting Agendas and Notes:'''  
 
'''Previous Meeting Agendas and Notes:'''  
 +
 
*[[Documentation_Cluster_Meeting_Minutes]]
 
*[[Documentation_Cluster_Meeting_Minutes]]
|bgcolor="#FFFFBB" style="border: 1px solid gray;padding-left:0.5em;padding-right:0.5em;" width="50%"|
+
| bgcolor="#FFFFBB" style="border: 1px solid gray;padding-left:0.5em;padding-right:0.5em;" width="50%" |
  
== Get Involved==
+
==Get Involved==
:''All meetings are conducted via GoToMeeting (see left-hand side of this page).''
 
  
* '''Share!'''
+
:
:* We want to know about your documentation ideas, solutions and challenges. You are invited to talk or present at one of our monthly meetings this year.
 
  
 +
*'''Share!'''
  
* '''Monthly Meeting'''
+
:*We want to know about your documentation ideas, solutions and challenges via the mailing list.
:* Our meeting will be the 4th week of each month on '''Mondays at 12pm MT.'''
 
  
 +
*'''Monthly Meeting'''
  
* '''Email List'''
+
:*No monthly meetings are being held at this time
:* Send Email to Group: [mailto:esip-documentation@lists.esipfed.org esip-documentation@lists.esipfed.org]
 
:* Join Email List: [http://lists.esipfed.org/mailman/listinfo/esip-documentation ESIP Documentation]
 
:* View Email Archive: [http://lists.esipfed.org/pipermail/listinfo/esip-documentation/ ESIP Documentation Email Archive]
 
  
 +
*'''Email List'''
  
* '''Biannual ESIP Meeting:'''
+
:*Send Email to Group: [mailto:esip-documentation@lists.esipfed.org esip-documentation@lists.esipfed.org]
:* The next ESIP Summer Meeting will be held during July 19-22, 2016 in Chapel Hill, N.C.
+
:*Join Email List: [http://lists.esipfed.org/mailman/listinfo/esip-documentation ESIP Documentation]
:* Documentation sessions from recent [http://commons.esipfed.org/2016WinterMeeting ESIP Winter Meeting].
+
:*View Email Archive: [http://lists.esipfed.org/pipermail/listinfo/esip-documentation/ ESIP Documentation Email Archive]
::* [http://commons.esipfed.org/node/8787 Metadata Systems and Tools]
 
::* [http://commons.esipfed.org/node/8823 Metadata Evaluation and Assessment]
 
 
|}
 
|}
 +
 
{| width="100%" cellpadding="0" cellspacing="0" style="zborder-top:1px solid #aaaaaa; border-collapse: collapse;"  
 
{| width="100%" cellpadding="0" cellspacing="0" style="zborder-top:1px solid #aaaaaa; border-collapse: collapse;"  
 
|- valign="top" bgcolor="pink"
 
|- valign="top" bgcolor="pink"
|bgcolor="lightblue" style="border: 1px solid gray;padding-left:0.5em;padding-right:0.5em;" width="50%"|
+
| bgcolor="lightblue" style="border: 1px solid gray;padding-left:0.5em;padding-right:0.5em;" width="50%" |
  
 
==Activities==
 
==Activities==
* [[Attribute_Convention_for_Data_Discovery_1-3| Attribute Convention for Data Discovery 1-3]]
 
|bgcolor="pink" style="border: 1px solid gray;padding-left:0.5em;padding-right:0.5em;" width="50%"|
 
  
== Related Activities (and Other Stuff)==
+
*[[Attribute_Convention_for_Data_Discovery_1-3| Attribute Convention for Data Discovery 1-3]]
 +
*[[ESIP Recommendations for FAIR Metadata| ESIP Recommendations for FAIR Metadata]]
 +
| bgcolor="pink" style="border: 1px solid gray;padding-left:0.5em;padding-right:0.5em;" width="50%" |
 +
 
 +
==Related Activities (and Other Stuff)==
 
see pages below with tagged with Documentation Cluster Category.
 
see pages below with tagged with Documentation Cluster Category.
 
|}
 
|}
  
 
[[category:Documentation]]
 
[[category:Documentation]]

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.