Difference between revisions of "Category:Documentation Cluster"

From Earth Science Information Partners (ESIP)
 
(187 intermediate revisions by 8 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
 +
 
 +
:*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:
 +
 
 +
 
 +
'''Telecon Instructions:'''
 +
 
 +
:No monthly telecons are currently being held.
 +
::
 +
 
 +
'''Previous Meeting Agendas and Notes:'''
 +
 
 +
*[[Documentation_Cluster_Meeting_Minutes]]
 +
| bgcolor="#FFFFBB" style="border: 1px solid gray;padding-left:0.5em;padding-right:0.5em;" width="50%" |
  
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.
+
==Get Involved==
  
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.
+
:
  
The group is co-chaired by Ted Habermann, NGDC and Ed Armstrong, JPL and welcomes participation of all ESIP members.
+
*'''Share!'''
  
 +
:*We want to know about your documentation ideas, solutions and challenges via the mailing list.
  
 +
*'''Monthly Meeting'''
  
==Next Teleconference==
+
:*No monthly meetings are being held at this time
The next documentation cluster will meet on Wednesday, Aug 15 at noon EDT.
 
Agenda: TBD
 
  
-----------------------------------------------------------------------------------------------
+
*'''Email List'''
To join the online portion of the meeting:
 
https://esipfed.webex.com/mw0306ld/mywebex/default.do?siteurl=esipfed&service=1
 
  
Meeting Password: 23138379
+
:*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]
 +
|}
  
-----------------------------------------------------------------------------------------------
+
{| width="100%" cellpadding="0" cellspacing="0" style="zborder-top:1px solid #aaaaaa; border-collapse: collapse;"
Call-in toll-free number (US/Canada): 1-877-668-4493
+
|- valign="top" bgcolor="pink"
Attendee access code: 23138379
+
| bgcolor="lightblue" style="border: 1px solid gray;padding-left:0.5em;padding-right:0.5em;" width="50%" |
  
 +
==Activities==
  
==Meeting Minutes==
+
*[[Attribute_Convention_for_Data_Discovery_1-3| Attribute Convention for Data Discovery 1-3]]
[[File:Documentation_Cluster_July_2012_Meeting.docx‎]]
+
*[[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%" |
  
Meeting Recording: [[https://esipfed.webex.com/esipfed/ldr.php?AT=pb&SP=MC&rID=60506572&rKey=cc863b0764781a9d]]
+
==Related Activities (and Other Stuff)==
 +
see pages below with tagged with Documentation Cluster Category.
 +
|}
  
Summer meeting 2012 - Documenting Data in Multiple Dialects
+
[[category:Documentation]]
Summary, notes, and recordings [[http://commons.esipfed.org/node/450]]
 

Latest revision as of 13: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.