Skip to content

Commit 158f824

Browse files
author
Quarto GHA Workflow Runner
committed
Built site for gh-pages
1 parent 4049104 commit 158f824

21 files changed

+23
-22
lines changed

.nojekyll

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
3817ae61
1+
685bf36f

_tex/index.tex

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -795,8 +795,8 @@ \subsubsection{Establish standards governance based on OSS best
795795
communities beyond a certain size that need to converge toward a new
796796
standard or rely on an existing standard. Developers and maintainers
797797
should review existing governance practices such as those provided by
798-
The Open Source
799-
Way(\href{https://www.theopensourceway.org/the_open_source_way-guidebook-2.0.html\#_project_and_community_governance}{https://www.theopensourceway.org/}).
798+
The Open Source Way,
799+
(\href{https://www.theopensourceway.org/the_open_source_way-guidebook-2.0.html\#_project_and_community_governance}{https://www.theopensourceway.org/}).
800800

801801
\subsubsection{Foster meta-standards
802802
development}\label{foster-meta-standards-development}

index.docx

4 Bytes
Binary file not shown.

index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -369,7 +369,7 @@ <h1 data-number="5"><span class="header-section-number">5</span> Recommendations
369369
<h2 data-number="5.1" class="anchored" data-anchor-id="science-and-technology-communities"><span class="header-section-number">5.1</span> Science and technology communities:</h2>
370370
<section id="establish-standards-governance-based-on-oss-best-practices" class="level3" data-number="5.1.1">
371371
<h3 data-number="5.1.1" class="anchored" data-anchor-id="establish-standards-governance-based-on-oss-best-practices"><span class="header-section-number">5.1.1</span> Establish standards governance based on OSS best practices</h3>
372-
<p>While best-practice governance principles are also relatively new in OSS communities, there is already a substantial set of prior art in this domain, on which the developers and maintainers of open-source data and metadata standards can rely. For example, it is now clear that governance principles and rules can mitigate some of the risks and challenges mentioned in <a href="#sec-challenges" class="quarto-xref">Section&nbsp;3</a>, especially for communities beyond a certain size that need to converge toward a new standard or rely on an existing standard. Developers and maintainers should review existing governance practices such as those provided by The Open Source Way(<a href="https://www.theopensourceway.org/the_open_source_way-guidebook-2.0.html#_project_and_community_governance">https://www.theopensourceway.org/</a>).</p>
372+
<p>While best-practice governance principles are also relatively new in OSS communities, there is already a substantial set of prior art in this domain, on which the developers and maintainers of open-source data and metadata standards can rely. For example, it is now clear that governance principles and rules can mitigate some of the risks and challenges mentioned in <a href="#sec-challenges" class="quarto-xref">Section&nbsp;3</a>, especially for communities beyond a certain size that need to converge toward a new standard or rely on an existing standard. Developers and maintainers should review existing governance practices such as those provided by The Open Source Way, (<a href="https://www.theopensourceway.org/the_open_source_way-guidebook-2.0.html#_project_and_community_governance">https://www.theopensourceway.org/</a>).</p>
373373
</section>
374374
<section id="foster-meta-standards-development" class="level3" data-number="5.1.2">
375375
<h3 data-number="5.1.2" class="anchored" data-anchor-id="foster-meta-standards-development"><span class="header-section-number">5.1.2</span> Foster meta-standards development</h3>

index.pdf

-3 Bytes
Binary file not shown.

sections/01-introduction.embed.ipynb

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@
1414
"\n",
1515
"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."
1616
],
17-
"id": "237e4b8d-d5a2-401e-b313-d41d2038effa"
17+
"id": "9500b23d-b44c-4ac5-ac0c-f7536760c6da"
1818
}
1919
],
2020
"nbformat": 4,

sections/01-introduction.out.ipynb

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@
1818
"\n",
1919
"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."
2020
],
21-
"id": "d2cb81f2-c0ac-4351-9a26-e2a406a94ea0"
21+
"id": "8b30ccd2-660c-4b1f-9f0f-37a609c4c70e"
2222
}
2323
],
2424
"nbformat": 4,

sections/02-use-cases.embed.ipynb

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@
3030
"\n",
3131
"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."
3232
],
33-
"id": "de5b2476-41cc-4a9e-b5ab-2548f626a1e1"
33+
"id": "014049fc-724d-4b68-895c-e6a2a0a64525"
3434
}
3535
],
3636
"nbformat": 4,

sections/02-use-cases.out.ipynb

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@
4646
"\n",
4747
"Wells, Donald Carson, and Eric W Greisen. 1979. “FITS-a Flexible Image Transport System.” In *Image Processing in Astronomy*, 445."
4848
],
49-
"id": "9e9d9d56-a3a1-4396-93b1-96bb1af6ccb5"
49+
"id": "80321ed0-29b3-4c17-ba91-384673fcc837"
5050
}
5151
],
5252
"nbformat": 4,

sections/03-challenges.embed.ipynb

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@
3636
"\n",
3737
"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."
3838
],
39-
"id": "e6443c76-a747-4fc8-b9db-b1f9ddb9278f"
39+
"id": "843ca8ee-a160-4218-90b1-93a1c8a83832"
4040
}
4141
],
4242
"nbformat": 4,

sections/03-challenges.out.ipynb

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@
5050
"\n",
5151
"Scroggins, Michael, and Bernadette M Boscoe. 2020. “Once FITS, Always FITS? Astronomical Infrastructure in Transition.” *IEEE Ann. Hist. Comput.* 42 (2): 42–54."
5252
],
53-
"id": "8b5c2d56-b40b-4f83-9ad9-061e6f12f87d"
53+
"id": "43f40ca3-152c-4de7-b30a-97f0457d55b5"
5454
}
5555
],
5656
"nbformat": 4,

sections/04-cross-sector.embed.ipynb

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@
2626
"\n",
2727
"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."
2828
],
29-
"id": "4b7accf6-7aee-4b5f-9099-750f76fcdbbd"
29+
"id": "ca41d343-91f1-4dc0-a4c7-ff0d669bed5d"
3030
}
3131
],
3232
"nbformat": 4,

sections/04-cross-sector.out.ipynb

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@
3636
"\n",
3737
"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*."
3838
],
39-
"id": "93af7b8f-0c2d-4d9e-bb97-970f79164620"
39+
"id": "d6048dbf-fdbf-4571-ac30-c075f60808bb"
4040
}
4141
],
4242
"nbformat": 4,

sections/05-recommendations-preview.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -193,7 +193,7 @@ <h1>Recommendations for open-source data and metadata standards</h1>
193193
<h2 class="anchored" data-anchor-id="science-and-technology-communities">Science and technology communities:</h2>
194194
<section id="establish-standards-governance-based-on-oss-best-practices" class="level3">
195195
<h3 class="anchored" data-anchor-id="establish-standards-governance-based-on-oss-best-practices">Establish standards governance based on OSS best practices</h3>
196-
<p>While best-practice governance principles are also relatively new in OSS communities, there is already a substantial set of prior art in this domain, on which the developers and maintainers of open-source data and metadata standards can rely. For example, it is now clear that governance principles and rules can mitigate some of the risks and challenges mentioned in <span class="citation" data-cites="sec-challenges">(<a href="#ref-sec-challenges" role="doc-biblioref"><strong>sec-challenges?</strong></a>)</span>, especially for communities beyond a certain size that need to converge toward a new standard or rely on an existing standard. Developers and maintainers should review existing governance practices such as those provided by The Open Source Way(<a href="https://www.theopensourceway.org/the_open_source_way-guidebook-2.0.html#_project_and_community_governance">https://www.theopensourceway.org/</a>).</p>
196+
<p>While best-practice governance principles are also relatively new in OSS communities, there is already a substantial set of prior art in this domain, on which the developers and maintainers of open-source data and metadata standards can rely. For example, it is now clear that governance principles and rules can mitigate some of the risks and challenges mentioned in <span class="citation" data-cites="sec-challenges">(<a href="#ref-sec-challenges" role="doc-biblioref"><strong>sec-challenges?</strong></a>)</span>, especially for communities beyond a certain size that need to converge toward a new standard or rely on an existing standard. Developers and maintainers should review existing governance practices such as those provided by The Open Source Way, (<a href="https://www.theopensourceway.org/the_open_source_way-guidebook-2.0.html#_project_and_community_governance">https://www.theopensourceway.org/</a>).</p>
197197
</section>
198198
<section id="foster-meta-standards-development" class="level3">
199199
<h3 class="anchored" data-anchor-id="foster-meta-standards-development">Foster meta-standards development</h3>

sections/05-recommendations.embed.ipynb

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@
1414
"\n",
1515
"### Establish standards governance based on OSS best practices\n",
1616
"\n",
17-
"While best-practice governance principles are also relatively new in OSS communities, there is already a substantial set of prior art in this domain, on which the developers and maintainers of open-source data and metadata standards can rely. For example, it is now clear that governance principles and rules can mitigate some of the risks and challenges mentioned in @sec-challenges, especially for communities beyond a certain size that need to converge toward a new standard or rely on an existing standard. Developers and maintainers should review existing governance practices such as those provided by The Open Source Way([https://www.theopensourceway.org/](https://www.theopensourceway.org/the_open_source_way-guidebook-2.0.html#_project_and_community_governance)).\n",
17+
"While best-practice governance principles are also relatively new in OSS communities, there is already a substantial set of prior art in this domain, on which the developers and maintainers of open-source data and metadata standards can rely. For example, it is now clear that governance principles and rules can mitigate some of the risks and challenges mentioned in @sec-challenges, especially for communities beyond a certain size that need to converge toward a new standard or rely on an existing standard. Developers and maintainers should review existing governance practices such as those provided by The Open Source Way, ([https://www.theopensourceway.org/](https://www.theopensourceway.org/the_open_source_way-guidebook-2.0.html#_project_and_community_governance)).\n",
1818
"\n",
1919
"### Foster meta-standards development\n",
2020
"\n",
@@ -48,7 +48,7 @@
4848
"\n",
4949
"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/>)."
5050
],
51-
"id": "cb292125-a5e9-461e-bf9e-2afceafd55fc"
51+
"id": "ec730c7e-cabd-4859-a4da-25c69c178b2f"
5252
}
5353
],
5454
"nbformat": 4,

sections/05-recommendations.out.ipynb

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@
1414
"\n",
1515
"### Establish standards governance based on OSS best practices\n",
1616
"\n",
17-
"While best-practice governance principles are also relatively new in OSS communities, there is already a substantial set of prior art in this domain, on which the developers and maintainers of open-source data and metadata standards can rely. For example, it is now clear that governance principles and rules can mitigate some of the risks and challenges mentioned in ([**sec-challenges?**](#ref-sec-challenges)), especially for communities beyond a certain size that need to converge toward a new standard or rely on an existing standard. Developers and maintainers should review existing governance practices such as those provided by The Open Source Way([https://www.theopensourceway.org/](https://www.theopensourceway.org/the_open_source_way-guidebook-2.0.html#_project_and_community_governance)).\n",
17+
"While best-practice governance principles are also relatively new in OSS communities, there is already a substantial set of prior art in this domain, on which the developers and maintainers of open-source data and metadata standards can rely. For example, it is now clear that governance principles and rules can mitigate some of the risks and challenges mentioned in ([**sec-challenges?**](#ref-sec-challenges)), especially for communities beyond a certain size that need to converge toward a new standard or rely on an existing standard. Developers and maintainers should review existing governance practices such as those provided by The Open Source Way, ([https://www.theopensourceway.org/](https://www.theopensourceway.org/the_open_source_way-guidebook-2.0.html#_project_and_community_governance)).\n",
1818
"\n",
1919
"### Foster meta-standards development\n",
2020
"\n",
@@ -56,7 +56,7 @@
5656
"\n",
5757
"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>."
5858
],
59-
"id": "ff6594b7-882e-4d8c-8aac-7d16652e64a6"
59+
"id": "1f5b009a-f37f-47bf-bd43-f409d1c3d4f8"
6060
}
6161
],
6262
"nbformat": 4,

sections/05-recommendations.qmd

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,8 @@ can rely. For example, it is now clear that governance principles and rules can
2020
mitigate some of the risks and challenges mentioned in @sec-challenges,
2121
especially for communities beyond a certain size that need to converge toward a
2222
new standard or rely on an existing standard. Developers and maintainers should
23-
review existing governance practices such as those provided by The Open Source Way([https://www.theopensourceway.org/](https://www.theopensourceway.org/the_open_source_way-guidebook-2.0.html#_project_and_community_governance)).
23+
review existing governance practices such as those provided by The Open Source Way,
24+
([https://www.theopensourceway.org/](https://www.theopensourceway.org/the_open_source_way-guidebook-2.0.html#_project_and_community_governance)).
2425

2526

2627
### Foster meta-standards development

sections/06-acknowledgments.embed.ipynb

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@
1212
"\n",
1313
"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."
1414
],
15-
"id": "b594478c-8220-4b16-bc63-d65e7cbd86f9"
15+
"id": "f5db73d7-47c4-4ceb-a2b4-db1d6171f76b"
1616
}
1717
],
1818
"nbformat": 4,

sections/06-acknowledgments.out.ipynb

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@
1212
"\n",
1313
"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."
1414
],
15-
"id": "aa618c8c-bd90-4d08-8f24-affcb555c87a"
15+
"id": "fb1101cc-da58-41f1-b578-2b0bcdfd4036"
1616
}
1717
],
1818
"nbformat": 4,

sections/07-participants.embed.ipynb

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@
4040
"| Yaroslav O. Halchenko | Dartmouth College |\n",
4141
"| Ziheng Sun | George Mason University |"
4242
],
43-
"id": "db37bdb3-318a-40cf-ba8e-f642d43bc61c"
43+
"id": "33e8ebfb-a617-474c-b903-b15fe66a1031"
4444
}
4545
],
4646
"nbformat": 4,

sections/07-participants.out.ipynb

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@
4040
"| Yaroslav O. Halchenko | Dartmouth College |\n",
4141
"| Ziheng Sun | George Mason University |"
4242
],
43-
"id": "d54486e0-813e-4379-bc7f-9c1c2abd27c5"
43+
"id": "0110122f-144d-4e9f-a902-f0363c1ba284"
4444
}
4545
],
4646
"nbformat": 4,

0 commit comments

Comments
 (0)