[tdwg-humboldt] User guide ("Humboldt Extension Documentation")

Fri May 12 17:31:21 UTC 2023

I have finished reviewing the user guide (https://docs.google.com/document/d/1rX4m94rtZDR_8iIe3RvRnNYKDJcmSX3ii4S5hCznEA0/edit?usp=sharing) and am ready to hand it off to Ani. Here are a few notes about what I did:

1. I added a header section using the standard format for TDWG documents. This isn’t required, but I think it’s helpful metadata to clarify the purpose of the document, the fact that it isn’t part of the standard, when it was updated, etc. I add a “Contributors” section and put in the names of people who I think contributed to the document in some way. Apologies if I missed someone – please add your name if I missed you. I tried to put the people who created the most content towards the beginning of the list, but since I wasn’t involved in putting the testing guide together, I may have it not quite right. I’ll leave it to Yani to decide about author order.
2. There were a number of wording changes that had been suggested by previous reviewers. Most of them made complete sense to me and I just accepted them to reduce the number of edits showing up in the record of changes. I did leave the track changes feature turned on when I made most of my edits, so maybe when Ani proofreads, she can just accept those changes if she agrees to them (in the interest of making the change record less cluttered).
3. I added a paragraph about the solution that involved creating an additional extension. I think it’s OK, but take a look at what I said. I wasn’t sure to write it as if the new extension were already done, so I kind of hedged on how I wrote it (I think I said that we planned to add it).
4. There are still a number of places where there are significant things missing or unresolved. For example there is the whole section about Peter and Rob’s controlled vocabulary. I think in most cases these will have to just be deleted for now since it doesn’t seem likely that they will be completed by our target date for being done (next Wednesday). Since this document isn’t going to be part of the standards submission itself, we have the freedom to edit it at will. If those additional parts do get finished, we can always put them back in. I think the best thing is for Yani to do a final read-through after Ani is done and make deletions for any stuff that’s incomplete. I think I put some kind of comment in every place were a decision of this sort needs to be made.

I think that’s it. The document is looking great and I can’t believe what a large amount of effort has been put into it to make it so nice. Kudos to the contributors!

Steve

--
Steven J. Baskauf, Ph.D.  he/him/his
Data Science and Data Curation Specialist / Librarian III
Jean & Alexander Heard Libraries, Vanderbilt University
Nashville, TN 37235, USA

Biodiversity Information Standards (TDWG) Executive Committee/Technical Architecture Group Chair
https://baskauf.github.io/

From: tdwg-humboldt <tdwg-humboldt-bounces at lists.tdwg.org> on behalf of ys628 <yanina.sica at yale.edu>
Date: Wednesday, May 10, 2023 at 6:53 AM
To: Humboldt Core TG <tdwg-humboldt at lists.tdwg.org>, wmh6 at cornell.edu <wmh6 at cornell.edu>
Subject: [tdwg-humboldt] Meeting!
Hi all,
Thank you all for working on the documents; I saw many of you made comments and revised both the general HE documentation and the implementation report. Much appreciated!
Wesley, the documentation on isLeastSpecificTargetCategoryQuantityInclusive looks great! You really improved it, thank you so much!

Unfortunately, I do not think I will be able to join the meeting today (I am in Frankfurt with lots of in person meetings...)

I will kindly ask you to discuss and the following points.

  *   Update the Humboldt Extension Quick Reference Guide<https://tdwg.github.io/hc/terms/> with updated terms
  *   Additional document to better explain eco:isLeastSpecificTargetCategoryQuantityInclusive (please add content, examples, links to other terms, etc. to this <https://docs.google.com/document/d/11fPW4JibRWUnrtTOZwDkAcxo5d-lwnATXyh3xmO65rs/edit> document). Markdown version?
As usual,

  *   Implementation report (please review and add yourself as an author here<https://docs.google.com/document/d/1RFdSHoyzWCQk9qO6uup4xQjWOMzPyBb-A0mcjj98hbk/edit#heading=h.8dmewb9wxxbk>)
  *   List of terms (please review all eco: terms here<https://docs.google.com/spreadsheets/d/1AbUUKDkgilbtHu9Dh_5V2dnOeQNbKBcRo4d7VEDyqOg/edit#gid=673949815>, tab: complete_term_list_from_JW)

     *   This will be added as an official document to the list of terms. The idea here, is that all the comments and relations of other terms will be better captured in a separate document instead of making a terribly long Comments section.

  *   Humboldt Extension Documentation (please review here<https://docs.google.com/document/d/1rX4m94rtZDR_8iIe3RvRnNYKDJcmSX3ii4S5hCznEA0/edit?usp=sharing>)

     *   This will not be an official document but will probably need to be linked in our presentation. Basically, I took our testing guide and removed all the parts related to the testing. We will need to update this document and polish it.
When to meet
Wednesdays 8 am EST (see your time here<https://www.timeanddate.com/worldclock/converter.html?iso=20230419T120000&p1=1440&p2=111&p3=37&p4=136&p5=51&p6=179&p7=64&p8=75&p9=224&p10=248&p11=152>)

Where to meet
Zoom link: https://yale.zoom.us/j/97318391101<https://www.google.com/url?q=https://yale.zoom.us/j/97318391101&sa=D&source=calendar&usd=2&usg=AOvVaw131_ZV9o-84ivZDjGbSTBJ>

Thank you and sorry for missing the meeting

Best,
Yani

Yanina V. Sica, PhD
Lead Data Team
Map of Life<https://mol.org/> | Center for Biodiversity and Global Change<https://bgc.yale.edu/>
Yale University
pronouns: she/her/hers
If you are receiving this email outside of your working hours, I am not expecting you to read or respond.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.tdwg.org/pipermail/tdwg-humboldt/attachments/20230512/c2aa7e7a/attachment-0001.html>