Skip to content

Commit

Permalink
Built site for gh-pages
Browse files Browse the repository at this point in the history
  • Loading branch information
Quarto GHA Workflow Runner committed Oct 11, 2024
1 parent 49ba701 commit 57f5197
Show file tree
Hide file tree
Showing 23 changed files with 212 additions and 278 deletions.
2 changes: 1 addition & 1 deletion .nojekyll
Original file line number Diff line number Diff line change
@@ -1 +1 @@
01dbea7f
0a1c56ae
44 changes: 8 additions & 36 deletions _tex/index.tex
Original file line number Diff line number Diff line change
Expand Up @@ -229,36 +229,6 @@
\end{frontmatter}


\section{Abstract}\label{abstract}

Recent progress in machine learning and artificial intelligence promises
to advance research and understanding across a wide range of fields and
activities. In tandem, increased awareness of the importance of open
data for reproducibility and scientific transparency is making inroads
in fields that have not traditionally produced large publicly available
datasets. Data sharing requirements from publishers and funders, as well
as from other stakeholders, have also created pressure to make datasets
with research and/or public interest value available through digital
repositories. However, to make the best use of existing data, and
facilitate the creation of useful future datasets, robust, interoperable
and usable standards need to evolve and adapt over time. The open-source
development model provides significant potential benefits to the process
of standard creation and adaptation. In particular, the development and
adaptation of standards can use long-standing socio-technical processes
that have been key to managing the development of software, and allow
incorporating broad community input into the formulation of these
standards. By adhering to open-source standards to formal descriptions
(e.g., by implementing schemata for standard specification, and/or by
implementing automated standard validation), processes such as automated
testing and continuous integration, which have been important in the
development of open-source software, can be adopted in defining data and
metadata standards as well. Similarly, open-source governance provides a
range of stakeholders a voice in the development of standards,
potentially enabling use cases and concerns that would not be taken into
account in a top-down model of standards development. On the other hand,
open-source models carry unique risks that need to be incorporated into
the process.

\section{Introduction}\label{sec-intro}

Data-intensive discovery has become an important mode of knowledge
Expand Down Expand Up @@ -1000,7 +970,7 @@ \section{Acknowledgements}\label{acknowledgements}
held at NSF headquarters in Alexandria, VA on April 8th-9th, 2024}. We
would like to thank the speakers and participants in this workshop for
the time and thought that they put into the workshop. A list of workshop
participants is provided as an appendix.
participants is provided as an appendix (Section~\ref{sec-appendix}).

The workshop and this report were funded through
\href{https://www.nsf.gov/awardsearch/showAward?AWD_ID=2334483&HistoricalAwards=false}{NSF
Expand All @@ -1010,10 +980,14 @@ \section{Acknowledgements}\label{acknowledgements}
in this report do not necessarily reflect those of the National Science
Foundation.

\section{References}\label{references}

\renewcommand{\bibsection}{}
\bibliography{references.bib}

\newpage

\section{Appendix: List of
participants}\label{appendix-list-of-participants}
\section{Appendix: List of participants}\label{sec-appendix}

\begin{longtable}[]{@{}ll@{}}
\toprule\noalign{}
Expand Down Expand Up @@ -1046,16 +1020,14 @@ \section{Appendix: List of
Ray E. Habermann & Metadata Game Changers \\
Raymond (Ray) Plante & NIST \\
Robert Hanisch & NIST \\
Saskia de Vries & Allen Institute for AI \\
Saskia de Vries & Allen Institute for Neural Dynamics \\
Steven Crawford & NASA \\
Vani Mandava & University of Washington \\
Yaroslav Halchenko & Dartmouth University \\
Ziheng Sun & George Mason University \\
\end{longtable}


\renewcommand\refname{References}
\bibliography{references.bib}



Expand Down
Binary file modified index.docx
Binary file not shown.
353 changes: 174 additions & 179 deletions index.html

Large diffs are not rendered by default.

Binary file modified index.pdf
Binary file not shown.
2 changes: 1 addition & 1 deletion sections/01-introduction.embed.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@
"\n",
"Data and metadata standards that use tools and practices of OSS (“open-source standards” henceforth) reap many of the benefits that the OSS model has provided in the development of other technologies. The present report explores how OSS processes and tools have affected the development of data and metadata standards. The report will survey common features of a variety of use cases; it will identify some of the challenges and pitfalls of this mode of standards development, with a particular focus on cross-sector interactions; and it will make recommendations for future developments and policies that can help this mode of standards development thrive and reach its full potential."
],
"id": "d02bb291-b4b8-4602-a2a8-23d2dd510c62"
"id": "e0275793-734e-4309-8897-4ea536aa2964"
}
],
"nbformat": 4,
Expand Down
2 changes: 1 addition & 1 deletion sections/01-introduction.out.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@
"\n",
"Wilkinson, Mark D, Michel Dumontier, I Jsbrand Jan Aalbersberg, Gabrielle Appleton, Myles Axton, Arie Baak, Niklas Blomberg, et al. 2016. “The FAIR Guiding Principles for Scientific Data Management and Stewardship.” *Sci Data* 3 (March): 160018."
],
"id": "48c2a4bb-4105-41c4-8095-10d9e6097de2"
"id": "f25987e3-95af-4ead-ac2c-76e89719159d"
}
],
"nbformat": 4,
Expand Down
2 changes: 1 addition & 1 deletion sections/02-use-cases.embed.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@
"\n",
"Another interesting use case for open-source standards is community/citizen science. An early example of this approach is OpenStreetMap <https://www.openstreetmap.org>, which allows users to contribute to the project development with code and data and freely use the maps and other related geospatial datasets. But this example is not unique. Overall, this approach has grown in the last 20 years and has been adopted in many different fields. It has many benefits for both the research field that harnesses the energy of non-scientist members of the community to engage with scientific data, as well as to the community members themselves who can draw both knowledge and pride in their participation in the scientific endeavor. It is also recognized that unique broader benefits are accrued from this mode of scientific research, through the inclusion of perspectives and data that would not otherwise be included. To make data accessible to community scientists, and to make the data collected by community scientists accessible to professional scientists, it needs to be provided in a manner that can be created and accessed without specialized instruments or specialized knowledge. Here, standards are needed to facilitate interactions between an in-group of expert researchers who generate and curate data and a broader set of out-group enthusiasts who would like to make meaningful contributions to the science. This creates a particularly stringent constraint on transparency and simplicity of standards. Creating these standards in a manner that addresses these unique constraints can benefit from OSS tools, with the caveat that some of these tools require additional expertise. For example, if the standard is developed using git/GitHub for versioning, this would require learning the complex and obscure technical aspects of these system that are far from easy to adopt, even for many professional scientists."
],
"id": "ff672cd8-8dce-4c1b-9aac-08cc40350ede"
"id": "98fe4965-8d8a-4055-9af3-24b79cb77bd5"
}
],
"nbformat": 4,
Expand Down
2 changes: 1 addition & 1 deletion sections/02-use-cases.out.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@
"\n",
"Wells, Donald Carson, and Eric W Greisen. 1979. “FITS-a Flexible Image Transport System.” In *Image Processing in Astronomy*, 445."
],
"id": "9b5dc5b7-dbc4-4772-9858-2881bd004aea"
"id": "e08e001b-5ee2-4963-9b78-1b0899d0eb73"
}
],
"nbformat": 4,
Expand Down
2 changes: 1 addition & 1 deletion sections/03-challenges.embed.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@
"\n",
"The development of open-source standards faces similar sustainability challenges to those faced by open-source software that is developed for research. Standards typically develop organically through sustained and persistent efforts from dedicated groups of data practitioners. These include scientists and the broader ecosystem of data curators and users. However, there is no playbook on the structure and components of a data standard, or the pathway that moves the implementation of a specific data architecture (e.g., a particular file format) to become a data standard. As a result, data standardization lacks formal avenues for success and recognition, for example through dedicated research grants (and see @sec-cross-sector). This hampers the long-term trajectory that is needed to inculcate a standard into the day-to-day practice of researchers."
],
"id": "38d90182-3c94-44b8-8717-52db26fa239f"
"id": "04084c1c-5945-4692-ad9d-aad2a10aa97e"
}
],
"nbformat": 4,
Expand Down
2 changes: 1 addition & 1 deletion sections/03-challenges.out.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@
"\n",
"Scroggins, Michael, and Bernadette M Boscoe. 2020. “Once FITS, Always FITS? Astronomical Infrastructure in Transition.” *IEEE Ann. Hist. Comput.* 42 (2): 42–54."
],
"id": "f5bee5d8-62e8-4a34-a57b-742e348bf718"
"id": "5703d200-943c-4f99-b983-e6c7c1c96b32"
}
],
"nbformat": 4,
Expand Down
2 changes: 1 addition & 1 deletion sections/04-cross-sector.embed.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@
"\n",
"Interactions of data and meta-data standards with commercial interests may provide specific sources of friction. This is because proprietary/closed formats of data can create difficulty at various transition points: from one instrument vendor to another, from data producer to downstream recipient/user, etc. On the other hand, in some cases, cross-sector collaborations with commercial entities may pave the way to robust and useful standards. For example, imaging measurements in human subjects (e.g., in brain imaging experiments) significantly interact with standards for medical imaging, and chiefly the Digital Imaging and Communications in Medicine (DICOM) standard, which is widely used in a range of medical imaging applications, including in clinical settings \\[@Larobina2023-vq, @Mustra2008-xk\\]. The standard emerged from the demands of the clinical practice in the 1980s, as digital technologies were came into widespread use in medical imaging, through joint work of industry organizations: the American College of Radiology and the National Association of Electronic Manufacturers. One of the defining features of the DICOM standard is that it allows manufacturers of instruments to define “private fields” that are compliant with the standard, but which may include idiosyncratically organized data and/or metadata. This provides significant flexibility, but can also easily lead to the loss of important information. Nevertheless, the human brain imaging case is exemplary of a case in which industry standards and research standards coexist and need to communicate with each other effectively to advance research use-cases, while keeping up with the rapid development of the technologies."
],
"id": "e94ab12b-95c1-4d7d-8192-aba2657707bf"
"id": "07077904-63b0-44ee-8ad5-54c9eaecdd2d"
}
],
"nbformat": 4,
Expand Down
2 changes: 1 addition & 1 deletion sections/04-cross-sector.out.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@
"\n",
"The National Science and Technology Council. 2022. “Desirable Characteristics of Data Repositories for Federally Funded Research.” *Executive Office of the President of the United States, Tech. Rep*."
],
"id": "6ca2495f-f0dd-49b2-be58-a8c7963cf025"
"id": "d4585359-8b4c-4f3e-908e-74f662e67826"
}
],
"nbformat": 4,
Expand Down
2 changes: 1 addition & 1 deletion sections/05-recommendations.embed.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@
"\n",
"Encourage cross-sector and cross-domain alliances that can impact successful standards creation. Invest in robust program management of these alliances to align pace and create incentives (for instance via Open Source Program Offices at Universities or other research organizations). Similar to program officers at funding agencies, standards evolution need sustained PM efforts. Multi-party partnerships should include strategic initiatives for standard establishment such as the Pistoia Alliance (<https://www.pistoiaalliance.org/>)."
],
"id": "50ce2ff0-f8a1-4217-86eb-719284b7497f"
"id": "44caf65c-2b55-4ba4-b1e6-93877140efd3"
}
],
"nbformat": 4,
Expand Down
2 changes: 1 addition & 1 deletion sections/05-recommendations.out.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@
"\n",
"Van Tuyl, Steve, ed. 2023. “Hiring, Managing, and Retaining Data Scientists and Research Software Engineers in Academia: A Career Guidebook from ADSA and US-RSE.” https://doi.org/<https://doi.org/10.5281/zenodo.8329337>."
],
"id": "9ab74357-d558-4d82-8e42-0ea2d9744e94"
"id": "8d8ee194-4142-41ff-b971-f3eb81f0e3de"
}
],
"nbformat": 4,
Expand Down
2 changes: 1 addition & 1 deletion sections/06-acknowledgments-preview.html
Original file line number Diff line number Diff line change
Expand Up @@ -153,7 +153,7 @@ <h2 id="toc-title">Table of contents</h2>
</div>
<main class="content quarto-banner-title-block" id="quarto-document-content"> <section id="acknowledgements" class="level1">
<h1>Acknowledgements</h1>
<p>This report was produced following a <a href="https://uwescience.github.io/2024-open-source-standards-workshop/">workshop held at NSF headquarters in Alexandria, VA on April 8th-9th, 2024</a>. We would like to thank the speakers and participants in this workshop for the time and thought that they put into the workshop. A list of workshop participants is provided as an appendix.</p>
<p>This report was produced following a <a href="https://uwescience.github.io/2024-open-source-standards-workshop/">workshop held at NSF headquarters in Alexandria, VA on April 8th-9th, 2024</a>. We would like to thank the speakers and participants in this workshop for the time and thought that they put into the workshop. A list of workshop participants is provided as an appendix (<span class="citation" data-cites="sec-appendix">(<a href="#ref-sec-appendix" role="doc-biblioref"><strong>sec-appendix?</strong></a>)</span>).</p>
<p>The workshop and this report were funded through <a href="https://www.nsf.gov/awardsearch/showAward?AWD_ID=2334483&amp;HistoricalAwards=false">NSF grant #2334483</a> from the NSF <a href="https://new.nsf.gov/funding/opportunities/pathways-enable-open-source-ecosystems-pose">Pathways to Enable Open-Source Ecosystems (POSE)</a> program. The opinions expressed in this report do not necessarily reflect those of the National Science Foundation.</p>
</section>
</main>
Expand Down
4 changes: 2 additions & 2 deletions sections/06-acknowledgments.embed.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,11 @@
"\n",
"# Acknowledgements\n",
"\n",
"This report was produced following a [workshop held at NSF headquarters in Alexandria, VA on April 8th-9th, 2024](https://uwescience.github.io/2024-open-source-standards-workshop/). We would like to thank the speakers and participants in this workshop for the time and thought that they put into the workshop. A list of workshop participants is provided as an appendix.\n",
"This report was produced following a [workshop held at NSF headquarters in Alexandria, VA on April 8th-9th, 2024](https://uwescience.github.io/2024-open-source-standards-workshop/). We would like to thank the speakers and participants in this workshop for the time and thought that they put into the workshop. A list of workshop participants is provided as an appendix (@sec-appendix).\n",
"\n",
"The workshop and this report were funded through [NSF grant #2334483](https://www.nsf.gov/awardsearch/showAward?AWD_ID=2334483&HistoricalAwards=false) from the NSF [Pathways to Enable Open-Source Ecosystems (POSE)](https://new.nsf.gov/funding/opportunities/pathways-enable-open-source-ecosystems-pose) program. The opinions expressed in this report do not necessarily reflect those of the National Science Foundation."
],
"id": "3fc54093-97fa-47c3-b4ef-7b24d6fc05ef"
"id": "67d2ff76-a2bf-4c5a-a424-95f99096a6d7"
}
],
"nbformat": 4,
Expand Down
4 changes: 2 additions & 2 deletions sections/06-acknowledgments.out.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,11 @@
"\n",
"# Acknowledgements\n",
"\n",
"This report was produced following a [workshop held at NSF headquarters in Alexandria, VA on April 8th-9th, 2024](https://uwescience.github.io/2024-open-source-standards-workshop/). We would like to thank the speakers and participants in this workshop for the time and thought that they put into the workshop. A list of workshop participants is provided as an appendix.\n",
"This report was produced following a [workshop held at NSF headquarters in Alexandria, VA on April 8th-9th, 2024](https://uwescience.github.io/2024-open-source-standards-workshop/). We would like to thank the speakers and participants in this workshop for the time and thought that they put into the workshop. A list of workshop participants is provided as an appendix (([**sec-appendix?**](#ref-sec-appendix))).\n",
"\n",
"The workshop and this report were funded through [NSF grant #2334483](https://www.nsf.gov/awardsearch/showAward?AWD_ID=2334483&HistoricalAwards=false) from the NSF [Pathways to Enable Open-Source Ecosystems (POSE)](https://new.nsf.gov/funding/opportunities/pathways-enable-open-source-ecosystems-pose) program. The opinions expressed in this report do not necessarily reflect those of the National Science Foundation."
],
"id": "ba5572ae-0800-44e1-bbc1-c1b6ed88796c"
"id": "87cdcc58-d3e3-483a-a35a-0d2ce8878a44"
}
],
"nbformat": 4,
Expand Down
2 changes: 1 addition & 1 deletion sections/06-acknowledgments.qmd
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
This report was produced following a
[workshop held at NSF headquarters in Alexandria, VA on April 8th-9th, 2024](https://uwescience.github.io/2024-open-source-standards-workshop/).
We would like to thank the speakers and participants in this workshop for the
time and thought that they put into the workshop. A list of workshop participants is provided as an appendix.
time and thought that they put into the workshop. A list of workshop participants is provided as an appendix (@sec-appendix).

The workshop and this report were funded through [NSF grant
#2334483](https://www.nsf.gov/awardsearch/showAward?AWD_ID=2334483&HistoricalAwards=false)
Expand Down
6 changes: 3 additions & 3 deletions sections/07-participants-preview.html
Original file line number Diff line number Diff line change
Expand Up @@ -145,13 +145,13 @@ <h6><i class="bi bi-journal-code"></i> Appendix: List of participants</h6>
<h2 id="toc-title">Table of contents</h2>

<ul>
<li><a href="#appendix-list-of-participants" id="toc-appendix-list-of-participants" class="nav-link active" data-scroll-target="#appendix-list-of-participants">Appendix: List of participants</a></li>
<li><a href="#sec-appendix" id="toc-sec-appendix" class="nav-link active" data-scroll-target="#sec-appendix">Appendix: List of participants</a></li>
</ul>
</nav>
</div>
<div id="quarto-margin-sidebar" class="sidebar margin-sidebar zindex-bottom">
</div>
<main class="content quarto-banner-title-block" id="quarto-document-content"> <section id="appendix-list-of-participants" class="level1 appendix">
<main class="content quarto-banner-title-block" id="quarto-document-content"> <section id="sec-appendix" class="level1 appendix">
<h1 class="appendix">Appendix: List of participants</h1>
<table class="caption-top table">
<thead>
Expand Down Expand Up @@ -259,7 +259,7 @@ <h1 class="appendix">Appendix: List of participants</h1>
</tr>
<tr class="odd">
<td>Saskia de Vries</td>
<td>Allen Institute for AI</td>
<td>Allen Institute for Neural Dynamics</td>
</tr>
<tr class="even">
<td>Steven Crawford</td>
Expand Down
24 changes: 4 additions & 20 deletions sections/07-participants.embed.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -4,24 +4,8 @@
"cell_type": "markdown",
"metadata": {},
"source": [
"#"
],
"id": "4153eeae-c6e8-4454-aa23-75e01d7e6c3c"
},
{
"cell_type": "raw",
"metadata": {
"raw_mimetype": "tex"
},
"source": [
"\\newpage"
],
"id": "d901c59b-f4d3-432f-a824-4c0ed4d9fa65"
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"# \n",
"\n",
"# Appendix: List of participants\n",
"\n",
"| Name | Affiliation |\n",
Expand Down Expand Up @@ -50,13 +34,13 @@
"| Ray E. Habermann | Metadata Game Changers |\n",
"| Raymond (Ray) Plante | NIST |\n",
"| Robert Hanisch | NIST |\n",
"| Saskia de Vries | Allen Institute for AI |\n",
"| Saskia de Vries | Allen Institute for Neural Dynamics |\n",
"| Steven Crawford | NASA |\n",
"| Vani Mandava | University of Washington |\n",
"| Yaroslav Halchenko | Dartmouth University |\n",
"| Ziheng Sun | George Mason University |"
],
"id": "2371d360-6936-4bcb-ac12-421c5d52c27b"
"id": "e7d849d7-d779-4132-97ac-7e2d9d9cb402"
}
],
"nbformat": 4,
Expand Down
Loading

0 comments on commit 57f5197

Please sign in to comment.