Contents

Review questions (1st round):

Sample questions:

  • What is your role?  Select one or more of:  data product generator, data distributor, tool developer, data user
  • Data product generator questions - 
    • Does this guide address questions you have had in designing data products for use within your community?  For broader use?
    • Does this guide organize data product development information in a way that will make this aspect of your work easier?
    • Do these recommendations address the challenges faced by your users in finding, evaluating and using their specific data of interest?
    • Would you be able to implement recommendations made here?
  • Data distributor questions -
    • Does this guide address questions you have discussed with your data providers?
    • If data product developers follow this guide, will your work cataloging and supporting their data be easier?
  • Data tool developer questions -
    • If data product developers follow this guide, will your work developing and maintaining tools for use with multiple types of data be easier?
  • Data User questions -
    • What type of data do you use?  (satellite, model, in situ, airborne, ...)
    • If you are a scientist, what is your science discipline ?
    • Do these recommendations address challenges you've encountered in finding, evaluating and using your data of interest?
  • General questions for everyone - 
    • Which sections of this guide are most relevant to your area of work?
    • Are there recommendations you disagree with?
    • Do you have concerns about any of these recommendations?
    • Are there additional recommendations that would help you?
    • Are there any terminologies, statements or recommendations that could be communicated more clearly or more properly defined? If so, please explain.

    • Do you feel that the document should be endorsed as a NASA Earth Science Suggested Practices document? Please provide a rationale for your answer, if not apparent from your responses to the above questions.

Targeted (and non-targeted) Reviewers:

Keep a list of individuals who should be invited via targeted emails (i.e. not via blanket mailing lists). This list can be useful for future reviews with similar topics.

It might help to use a table, with name, email, date invited, whether there was a response, whether the person has been added to Jama, etc.

The Tableenhancer macro wrapped around a table lets you make sortable tables that are helpful for this.

Add people who were not targeted but who responded to the blanket email announcements.

Also track who actually commented in the 1st round so those people can be contacted for the 2nd round review.

Table Enhancer for Confluence

Table Enhancer for Confluence does not have a valid license.

NameEmailDate of invitation emailResponse?In Jama? (P= Project Team, or O=Outside project team)Comments?Date of 2nd round invitation email Response...
























































































































































































































Draft Letter to Reviewers (1st Round):

Sample letter - also look at past reviews for other examples.

Hello,

NASA's Earth Science Data and Information Systems (ESDIS) Standards Coordination Office (ESCO) is requesting comments on recommendations for the Zarr storage specification.  You are invited to review the Cloud-optimized persistence using Zarr in the context of your experience with Earth science data, for its suitability for operational use.  Your insights will help improve this document, and determine whether it should be adopted as a NASA Convention  for Earth Science data producers.

This review is intended for the community of earth science data users who may benefit from the adoption of the Zarr cloud optimized storage format for data access and scientific computing.  A clear understanding of both the advantages and limitations of this format are necessary to best serve these end user communities.  

The ESCO review will run through Oct  3, 2023. 

The role of the ESDIS Standards Coordination Office  is to conduct a review of this document by soliciting comments from a cross section of the Earth Science community. Reviewers are invited to read the document and answer the questions provided on the review web page. The ESCO recognizes that not all reviewers will be familiar with all of the content of the document. Reviewers are welcome to review those parts of the document that they have experience with.  You only need to answer questions applicable to you.  All additional comments are welcome.

If approved, these recommendations will serve as a NASA Convention (i.e.,a specification in common use among some members of the NASA ESDS community).

The document to review, the review questions, and the instructions for review are at this location (Jama landing page).

If you or your team member can review this document, please send names, email addresses, and Earthdata login usernames to esco-staff@lists.nasa.gov.  The ESO Staff will add your names as reviewers in the Jama system.  You may also send any questions about the review to the ESCO staff at esco-staff@lists.nasa.gov.

Draft Letter to Reviewers (2nd Round)

Sample letter - also look at past reviews for other examples.

NOTE: This was adapted from the DQWG 2nd round review letter.

Thank you for your thoughtful reviews of ESDS-RFC-041: Data Product Development Guide for Data Producers. Your comments will help make these recommendations more generally useful and widely applicable.

Together with the authors, the ESDIS Standards Office has produced an updated version of the document to address the comments we received. The authors of this document also replied to each of your comments in the original review of this document. The original review copy and comments are still available here:  https://rms.earthdata.nasa.gov/review.req#/r:REV-514. Please note that since the review on the original document has closed, you can only view the authors' replies there, but can not comment anymore. You can add new comments to the updated version of this document (review link provided below).

Please take a look at this updated version and provide any additional feedback you may have by June 19th. Please note that since you’ve already replied to the reviewer questions (questions under the Guide for Reviewers section) in the original document, you don’t need to reply to them again but are you are welcome to comment further.

As before, you can provide comments into Jama directly at the URL: 

https://rms.earthdata.nasa.gov/review.req#/r:REV-527

Or you can respond via email.  The revised document is attached.

The due date for this review is June 19, 2020 at 11:00 PM EDT.

Thanks for your help, and best regards,

ESDIS Standards Office


Comments

Use the comments section to capture significant email exchanges. Save the announcement email, save the targeted invitation email, save any comments received via email (these must be forwarded to the authors).