Merge pull request #6 from eco4cast/utterances-comment

Adding in utterances as feature for comments

index.qmd

@@ -5,6 +5,9 @@ format:
     toc: true
     toc-depth: 3
     toc-position: left
+    comments:
+      utterances:
+         repo: eco4cast/efi-ci-workshop-2024
 ---
 
 # EFI Cyberinfrastructure Workshop April 2024
@@ -157,21 +160,8 @@ footnotes](https://quarto.org/docs/authoring/footnotes-and-citations.html).
 
 ## Current documents 
 
-### [Step by Step Summary of Workshop](workshopsummary/summary.qmd) <!-- Link to the summary -->
-
-The workshop's agenda was crafted to cover essential CI design topics recommended by the organizing committee for inclusion in the handbook and to gather valuable input from attendees. Throughout the workshop, we documented the presentations, breakout sessions, and plenary discussions meticulously through detailed notes and audio recording transcripts. These materials were subsequently reviewed and refined to ensure clarity and accuracy in preparation for summarization.
-
-Each workshop session was summarized with the assistance of a Large Language Model AI specifically Claude 3 Opus. We provided the AI with the workshop's annotated agenda, transcripts of audio recordings, presentation slides, and notes along with specific instructions to generate detailed summaries. These instructions were iteratively fine-tuned to ensure the summaries met our standards. Finally, we carefully reviewed the summaries to ensure they accurately reflected the workshop's discussions. Special attention was given to common themes emerging from the breakout sessions which required deeper interpretation and analysis. The collation of those notes can be found in the following document which the community and workshop participants are encouraged to comment on.
-
-### [Briefing Paper](workshopsummary/brief.qmd) <!-- Link to the briefing paper -->
-
-A 1500-word briefing paper has been prepared in lieu of the initially planned community-developed handbook of CI design principles. After collating the workshop materials and reviewing the workshop exit survey, it was apparent that the workshop discussions were held at a higher level than necessary to achieve the initial goal. At this higher non-technical level of discussion, there were existing design principles that participants agreed with, but there are nonetheless obstacles to implementation.
-
-The briefing paper outlines the necessity of cyberinfrastructure (CI) and highlights key thematic obstacles to implementation as identified in the workshop. Additionally, it includes recommendations derived from these themes. The target audience includes potential advocates in agencies, scientific societies, stakeholder groups, and boundary organizations who may not possess technical expertise but can recognize the need for CI. The broader EFI community and workshop participants are encouraged to comment on this briefing paper.
-
-### [Appendix](reference/EFI_CI_reference.qmd) <!-- Link to the appendix -->
-
-The appendix includes acronyms, a glossary of terms, and a list of named participants and their affiliations.
+* [Workshop Summary](workshopsummary/index.qmd) <!-- Link to the summary -->
+* [Reference Documents](reference/index.qmd) <!-- Link to the appendix -->
 
 ## Organizers and Funders
 

reference/EFI_CI_reference.qmd

@@ -1,6 +1,13 @@
 ---
 title: "{{< fa arrow-right >}} Acronyms and Definitions"
-format: html
+format:
+  html:
+    toc: true
+    toc-depth: 3
+    toc-position: left
+    comments:
+      utterances:
+         repo: eco4cast/efi-ci-workshop-2024
 ---
 
 ## Acronyms and Abbreviations

reference/index.qmd

@@ -5,5 +5,12 @@ format:
     toc: true
     toc-depth: 3
     toc-position: left
+    comments:
+      utterances:
+         repo: eco4cast/efi-ci-workshop-2024
 ---
+## Reference Documents
+
+* [Acronyms and Definitions](EFI_CI_reference.qmd)
+* [Participants](participants.qmd)
 

reference/participants.qmd

@@ -1,6 +1,13 @@
 ---
 title: "{{< fa arrow-right >}} Participants"
-format: html
+format:
+  html:
+    toc: true
+    toc-depth: 3
+    toc-position: left
+    comments:
+      utterances:
+         repo: eco4cast/efi-ci-workshop-2024
 ---
 
 ## Named Participants and Affiliations

workshopsummary/brief.qmd

@@ -1,7 +1,13 @@
 ---
 title: "{{< fa arrow-right >}} EFI-CI Briefing Paper"
-format: html
-author: "Cameron Thompson"
+format:
+  html:
+    toc: true
+    toc-depth: 3
+    toc-position: left
+    comments:
+      utterances:
+         repo: eco4cast/efi-ci-workshop-2024
 ---
 
 # Cyberinfrastructure to Enable Ecological Forecasting for Decision Making

workshopsummary/index.qmd

@@ -5,4 +5,19 @@ format:
     toc: true
     toc-depth: 3
     toc-position: left
+    comments:
+      utterances:
+         repo: eco4cast/efi-ci-workshop-2024
 ---
+## Workshop Summary Documents
+
+### [Workshop Summary](summary.qmd)
+The workshop's agenda was crafted to cover essential CI design topics recommended by the organizing committee for inclusion in the handbook and to gather valuable input from attendees. Throughout the workshop, we documented the presentations, breakout sessions, and plenary discussions meticulously through detailed notes and audio recording transcripts. These materials were subsequently reviewed and refined to ensure clarity and accuracy in preparation for summarization.
+
+Each workshop session was summarized with the assistance of a Large Language Model AI specifically Claude 3 Opus. We provided the AI with the workshop's annotated agenda, transcripts of audio recordings, presentation slides, and notes along with specific instructions to generate detailed summaries. These instructions were iteratively fine-tuned to ensure the summaries met our standards. Finally, we carefully reviewed the summaries to ensure they accurately reflected the workshop's discussions. Special attention was given to common themes emerging from the breakout sessions which required deeper interpretation and analysis. The collation of those notes can be found in the following document which the community and workshop participants are encouraged to comment on.
+
+### [Briefing Paper](brief.qmd) <!-- Link to the briefing paper -->
+
+A 1500-word briefing paper has been prepared in lieu of the initially planned community-developed handbook of CI design principles. After collating the workshop materials and reviewing the workshop exit survey, it was apparent that the workshop discussions were held at a higher level than necessary to achieve the initial goal. At this higher non-technical level of discussion, there were existing design principles that participants agreed with, but there are nonetheless obstacles to implementation.
+
+The briefing paper outlines the necessity of cyberinfrastructure (CI) and highlights key thematic obstacles to implementation as identified in the workshop. Additionally, it includes recommendations derived from these themes. The target audience includes potential advocates in agencies, scientific societies, stakeholder groups, and boundary organizations who may not possess technical expertise but can recognize the need for CI. The broader EFI community and workshop participants are encouraged to comment on this briefing paper.

workshopsummary/summary.qmd

@@ -1,7 +1,14 @@
 ---
 title: "{{< fa arrow-right >}} EFI-CI Workshop Summary"
 author: "Cameron Thompson"
-format: html
+format:
+  html:
+    toc: true
+    toc-depth: 3
+    toc-position: left
+    comments:
+      utterances:
+         repo: eco4cast/efi-ci-workshop-2024
 ---
 
 # EFI Cyberinfrastructure Workshop Summary