Skip to content

Commit

Permalink
[STY] pacify style checkers and fix links (#581)
Browse files Browse the repository at this point in the history
  • Loading branch information
Remi-Gau authored Nov 20, 2024
1 parent 8291fa9 commit 9267247
Show file tree
Hide file tree
Showing 9 changed files with 104 additions and 80 deletions.
2 changes: 2 additions & 0 deletions .github/workflows/validation.yml
Original file line number Diff line number Diff line change
Expand Up @@ -75,6 +75,8 @@ jobs:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
submodules: true
- uses: gaurav-nelson/github-action-markdown-link-check@v1
with:
use-quiet-mode: yes
Expand Down
3 changes: 2 additions & 1 deletion docs/blog/posts/2020-03-12-steering-group-minutes.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,8 @@ Regarding discussions on where to host our historical specification pdfs (please

- BEP leads in control of their repository

- Follow our [code of conduct](https://github.com/bids-standard/bids-specification/blob/master/CODE_OF_CONDUCT.md) and [governance document](https://docs.google.com/document/d/1R-J2lL9V_wIkYhye4zH-feyl4P4J8NyO40rIYyY141o/)
- Follow our [code of conduct](../../collaboration/bids_github/CODE_OF_CONDUCT.md)
and [governance document](../../collaboration/governance.md)

- Keeping it reasonable lenient

Expand Down
2 changes: 1 addition & 1 deletion docs/blog/posts/2020-03-23-steering-group-minutes.md
Original file line number Diff line number Diff line change
Expand Up @@ -73,7 +73,7 @@ The Steering Group gave direction on handling author lists on Zenodo - make it a

- Genetic Information was in the BEP lead's fork of BIDS-examples (after the meeting a [PR was opened](https://github.com/bids-standard/bids-examples/pull/178)).

- Regarding the [Zenodo authorship](https://github.com/bids-standard/bids-specification/issues/66) discussion, the Steering Group considered for the list to either be first/last+alphabetical order in the middle or a single authored “[BIDS Contributors Group](https://bids.neuroimaging.io/governance.html#bids-contributors-group)”.
- Regarding the [Zenodo authorship](https://github.com/bids-standard/bids-specification/issues/66) discussion, the Steering Group considered for the list to either be first/last+alphabetical order in the middle or a single authored “[BIDS Contributors Group](../../collaboration/governance.md)”.

- Decision toward “BIDS Contributors Group” similar to how ADNI does it.

Expand Down
14 changes: 8 additions & 6 deletions docs/blog/posts/community-survey-2024.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,12 +4,14 @@ slug: "BIDS Community Survey 2024"
author: BIDS Maintainers
---

The BIDS [Maintainers](https://bids.neuroimaging.io/governance.html#bids-maintainers-group)
and [Steering Group](https://bids.neuroimaging.io/governance.html#bids-steering-group)
invite you to fill out the 2024 BIDS Community Survey from now until **April 3, 2024**.
We want to hear from users and non-users, experts and non-experts.
This is an easy and great way to contribute to BIDS. Please share your views and share this survey widely!
The BIDS [Maintainers](../../collaboration/governance.md#bids-maintainers-group)
and [Steering Group](../../collaboration/governance.md#bids-steering-group)
invite you to fill out the 2024 BIDS Community Survey from now until **April 3,
2024**. We want to hear from users and non-users, experts and non-experts. This
is an easy and great way to contribute to BIDS. Please share your views and
share this survey widely!

Survey: [bit.ly/bidssurvey2024](https://bit.ly/bidssurvey2024)

![A QR code for the BIDS community survey](../../assets/img/bit.ly_bidssurvey2024.jpeg){: width="250" }
![A QR code for the BIDS community survey](../../assets/img/bit.ly_bidssurvey2024.jpeg){:
width="250" }
16 changes: 11 additions & 5 deletions docs/blog/posts/steering-group-election-2023.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,15 +10,21 @@ We are excited to announce the results of the BIDS Steering Group election.

<!-- more -->

We are pleased to announce that the newest members of the BIDS Steering Group are Dora Hermes and Camille Maumet!
We are pleased to announce that the newest members of the BIDS Steering Group
are Dora Hermes and Camille Maumet!

Dora and Camille have been elected to a term lasting from 2024-2026, and are replacing outgoing members Guiomar Nise and Robert Oostenveld.
Dora and Camille have been elected to a term lasting from 2024-2026,
and are replacing outgoing members Guiomar Nise and Robert Oostenveld.

Additionally, three amendments to the governance document have been approved and will be added to the [BIDS website](https://bids.neuroimaging.io/governance.html) in the coming week.
Additionally, three amendments to the governance document have been approved and
will be added to the [BIDS website](../../collaboration/governance.md) in the
coming week.

The results of the election may be viewed at [https://www.rcv123.org/results/qkAoDSKtNyGv6nSMCVZvCM/](https://www.rcv123.org/results/qkAoDSKtNyGv6nSMCVZvCM/).
The results of the election may be viewed at
[https://www.rcv123.org/results/qkAoDSKtNyGv6nSMCVZvCM/](https://www.rcv123.org/results/qkAoDSKtNyGv6nSMCVZvCM/).

Thanks to all contributors for your participation, and congratulations to Dora and Camille!
Thanks to all contributors for your participation,
and congratulations to Dora and Camille!

Sincerely,

Expand Down
9 changes: 4 additions & 5 deletions docs/collaboration/governance.md
Original file line number Diff line number Diff line change
Expand Up @@ -119,8 +119,7 @@ consecutive years as chair. BIDS Steering Group members may hold other
BIDS roles at the same time, for example BEP Working Group chair.

The BIDS Steering Group is the authority of last resort in addressing
conflicts among groups and alleged violations of the [Code of
Conduct](https://github.com/bids-standard/bids-specification/blob/master/CODE_OF_CONDUCT.md).
conflicts among groups and alleged violations of the [Code of Conduct](./bids_github/CODE_OF_CONDUCT.md).

The Steering Group may delegate tasks as needed to fulfill its responsibilities.

Expand All @@ -141,8 +140,8 @@ aim of extending or modifying the BIDS standard into their domain of
interest. This can be either an unspecified modality or derivative.
The BEP Lead and Working Group will determine how they organize their
work, following the BIDS governance standards laid out in section 4 of
this document and the BIDS [Code of
Conduct](https://github.com/bids-standard/bids-specification/blob/master/CODE_OF_CONDUCT.md). The BEP Working Group work is completed when their BEP has become a Merged BEP.
this document and the BIDS [Code of Conduct](./bids_github/CODE_OF_CONDUCT.md).
The BEP Working Group work is completed when their BEP has become a Merged BEP.

### BEP Leads Group

Expand Down Expand Up @@ -456,7 +455,7 @@ blog](http://reproducibility.stanford.edu/blog/) provides tutorials and
community survey results.

All BIDS community members are required to follow the
[BIDS code of conduct](https://github.com/bids-standard/bids-specification/blob/master/CODE_OF_CONDUCT.md).
[BIDS code of conduct](./bids_github/CODE_OF_CONDUCT.md).
Please contact the BIDS maintainers at [[email protected]](mailto:[email protected])
if you have any concerns or would like to report a violation.

Expand Down
3 changes: 1 addition & 2 deletions docs/collaboration/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,8 +41,7 @@ There are so many ways to help us build this community.
- You could help someone else learn the benefits of BIDS by giving a talk in your local organization
- Or you could work on [building a BIDS App](https://bids-website.readthedocs.io/en/latest/tools/bids-apps.html){:target="_blank"}!

<b>The only requirement is that everyone who contributes adheres to our
[BIDS Code of Conduct](https://github.com/bids-standard/bids-specification/blob/master/CODE_OF_CONDUCT.md).</b>
<b>The only requirement is that everyone who contributes adheres to our [BIDS Code of Conduct](./bids_github/CODE_OF_CONDUCT.md).</b>

Thank you for your contributions!

Expand Down
124 changes: 65 additions & 59 deletions docs/impact/index.md
Original file line number Diff line number Diff line change
@@ -1,45 +1,52 @@
# BIDS Impact

The Brain Imaging Data Structure (BIDS) is an open global community driving the
standardization of neuroscience data across a broad and growing range of modalities
and health research disciplines. First released in June 2016, it is supported by a
worldwide research network and endorsed by organizations like the International
The Brain Imaging Data Structure (BIDS) is an open global community driving the
standardization of neuroscience data across a broad and growing range of modalities
and health research disciplines. First released in June 2016, it is supported by a
worldwide research network and endorsed by organizations like the International
Neuroinformatics Coordinating Facility ([INCF](https://www.incf.org/)).

BIDS encompasses:

- Over 40 domain-specific and modality-specific technical specifications across
scientific and technical domains.
- 100+ sample data models for BIDS specifications in
[bids-examples](https://github.com/bids-standard/bids-examples). Read more about
the [BIDS specification](https://bids-specification.readthedocs.io/en/stable/).
- 2000 open datasets across repositories including
[OpenNeuro](https://www.openneuro.org). Read more about [BIDS Datasets](/docs/datasets/index.md).
- Open software conversion and analytics tools, and global infrastructure for
collaborating on emerging standards in neuroscience
[Poldrack, et al, 2024](https://direct.mit.edu/imag/article/doi/10.1162/imag_a_00103/119672/The-past-present-and-future-of-the-brain-imaging).
- ~30,000 annual website visits from a very large community of neuroscience researchers
actively consulting the BIDS specifications (April 2023-24).
- Over 300 BIDS contributors currently supporting and maintaining BIDS community
resources and tools.
- Open working processes through online collaborative tools including GitHub,
GitHub Pages, ReadTheDocs, Google Docs, and OSF.

The BIDS core steering and maintainers groups work with the community to optimize open
adherence to FAIR principles (Findable, Accessible, Interoperable, and Reusable,
[Wilkinson, et al, 2016](https://www.nature.com/articles/sdata201618)) and to actively
- Over 40 domain-specific and modality-specific technical specifications
across scientific and technical domains.

- 100+ sample data models for BIDS specifications
in the [bids-examples](../datasets/examples.md).
Read more about the [BIDS specification](https://bids-specification.readthedocs.io/en/stable/).

- 2000 open datasets across repositories
including [OpenNeuro](https://www.openneuro.org).
Read more about [BIDS Datasets](../datasets/index.md).

- Open software conversion and analytics tools,
and global infrastructure for collaborating on emerging standards in neuroscience
[Poldrack, et al, 2024](https://direct.mit.edu/imag/article/doi/10.1162/imag_a_00103/119672/The-past-present-and-future-of-the-brain-imaging).

- ~ 30,000 annual website visits from a very large community of neuroscience researchers
actively consulting the BIDS specifications (April 2023-24).

- Over 300 BIDS contributors currently supporting
and maintaining BIDS community resources and tools.

- Open working processes through online collaborative tools
including GitHub, GitHub Pages, ReadTheDocs, Google Docs, and OSF.

The BIDS core steering and maintainers groups work with the community to optimize open
adherence to FAIR principles (Findable, Accessible, Interoperable, and Reusable,
[Wilkinson, et al, 2016](https://www.nature.com/articles/sdata201618)) and to actively
lower barriers to adoption.

## Measuring BIDS Impact

### Datasets

Over the years, the number of shared datasets available to the public has
greatly increased. At its heart, adoption of the BIDS standard across datasets
aids in the sharing of data and collaboration of research through the standardization
of descriptive files names and the organization of data. BIDS organized datasets are
available through public repositories such as [Openneuro.org](https://openneuro.org/)
and the number of publicly available BIDS datasets continues to grow every year.
Over the years, the number of shared datasets available to the public has
greatly increased. At its heart, adoption of the BIDS standard across datasets
aids in the sharing of data and collaboration of research through the standardization
of descriptive files names and the organization of data. BIDS organized datasets are
available through public repositories such as [Openneuro.org](https://openneuro.org/)
and the number of publicly available BIDS datasets continues to grow every year.

<!-- use snippet to include a file
https://facelessuser.github.io/pymdown-extensions/extensions/snippets/#snippets-notation
Expand All @@ -49,9 +56,9 @@ https://facelessuser.github.io/pymdown-extensions/extensions/snippets/#snippets-

### Citation Count

As the adoption of the BIDS standard across neuroimaging datasets has grown, so have
citations for work that uses BIDS data and BIDS apps. To aid in searching for publications
relevant to the BIDS standard, we have included some examples of BIDS references that are
As the adoption of the BIDS standard across neuroimaging datasets has grown, so have
citations for work that uses BIDS data and BIDS apps. To aid in searching for publications
relevant to the BIDS standard, we have included some examples of BIDS references that are
centralized in a [zotero group](https://www.zotero.org/groups/5111637/bids)

<!-- use snippet to include a file
Expand All @@ -61,10 +68,10 @@ https://facelessuser.github.io/pymdown-extensions/extensions/snippets/#snippets-
--8<-- "tmp/citation_per_year.html"

### GitHub stars
GitHub stars quantify the number of users that have marked a repository as a favorite and have
chosen to follow the changes made to that repository. Below is a table of GitHub repos that are
associated with the BIDS standard and their star count. By tracking repo interest via GitHub stars,
we can quantify which BIDS-associated tools are of the highest interest to the research community.
GitHub stars quantify the number of users that have marked a repository as a favorite and have
chosen to follow the changes made to that repository. Below is a table of GitHub repos that are
associated with the BIDS standard and their star count. By tracking repo interest via GitHub stars,
we can quantify which BIDS-associated tools are of the highest interest to the research community.

| repository | stars |
| ----------------- | ------------------------------------------------------------------------------------------ |
Expand Down Expand Up @@ -97,7 +104,7 @@ Our list of contributors are captured in our
We update the contributor appendix every specification release. As of July 2023,
we have over 300 credited contributors.

The table below provides a brief account of the number of contributors per repository. Estimated demographics and affiliations
The table below provides a brief account of the number of contributors per repository. Estimated demographics and affiliations
of contributors is also provided below.

| repository | all-contributors | github |
Expand Down Expand Up @@ -153,24 +160,24 @@ github-dependents-info --repo bids-standard/pybids --badgemarkdownfile ./dashboa
## BIDS History

Since its origin, the BIDS standard has revolutionized the way in which neuroimaging
research is done. The origin of the BIDS standard is commonly traced back to 2014,
when a social media post ignited a deeper discussion about a new way of sharing
data, that would ultimately lead to a set of standards that would improve scientific
collaboration efforts.

Following this initial discussion (and on the shoulders of many many volunteer hours
by maintainers and the community at large) the BIDS standard saw significant adoption
in the neuroimaging research landscape and continues to expand every day. A more complete
history and discussion about the future of the BIDS landscape can be found in this
research is done. The origin of the BIDS standard is commonly traced back to 2014,
when a social media post ignited a deeper discussion about a new way of sharing
data, that would ultimately lead to a set of standards that would improve scientific
collaboration efforts.

Following this initial discussion (and on the shoulders of many many volunteer hours
by maintainers and the community at large) the BIDS standard saw significant adoption
in the neuroimaging research landscape and continues to expand every day. A more complete
history and discussion about the future of the BIDS landscape can be found in this
[recent publication](https://pmc.ncbi.nlm.nih.gov/articles/PMC10516110/).

The BIDS standard continues to be adopted by a larger share of the community each year.
The BIDS standard continues to be adopted by a larger share of the community each year.
We have seen a large and growing number of visitors to the BIDS website. A large number of
BIDS users also continue to explore the BIDS Specification and contribute to the community every month.
BIDS users also continue to explore the BIDS Specification and contribute to the community every month.

We also document centers, institutes, and databases around the world that have implemented BIDS as
their organizational structure. While the list continues to grow, an initial list of centers and the associated
BIDS initiatives or database can be found
BIDS initiatives or database can be found
[here](https://docs.google.com/spreadsheets/d/1aySjPpEGGQwFcOavkQdcvk2t2UMXt_zoTzWLWUmq20M/edit#gid=0).

### Website and Specification traffic dashboards
Expand Down Expand Up @@ -204,8 +211,8 @@ that have implemented BIDS as their organizational structure.

### Neurostars

We also track the interest and usage of the BIDS standard via discussions on Neurostars
to help us estimate trends in usage. Below is a snapshot as of ??? (date).
We also track the interest and usage of the BIDS standard via discussions on Neurostars
to help us estimate trends in usage. Below is a snapshot as of ??? (date).
<!--
TODO add automation to update every 6 months
-->
Expand All @@ -231,12 +238,11 @@ As of July 1, 2020, we have 183 people signed up for our
[BIDS email list](https://forms.gle/JFo2aEkYbKY4EbmE6) and 412 members on our
[google group](https://groups.google.com/forum/#!forum/bids-discussion).


## How the BIDS team can help you

If you are in the process of putting together a grant, **please email/message
the pillar lead** that is most closely associated with your proposed grant or the
BIDS maintainers email ([[email protected]](mailto:[email protected]))
the pillar lead** that is most closely associated with your proposed grant or the
BIDS maintainers email ([[email protected]](mailto:[email protected]))
so we may help support this. Our organization is structured into 3 pillars: standard,
tools, and collaboration.

Expand All @@ -246,7 +252,7 @@ writers or related initiatives to receiving a letter of support from the
Steering Group.

Regarding **requesting a letter of support** - please submit a drafted letter of
support to the collaboration lead or the BIDS maintainers email
support to the collaboration lead or the BIDS maintainers email
([[email protected]](mailto:[email protected])) so we may review internally.

Please include how you plan on giving back to the BIDS community. The primary
Expand All @@ -264,9 +270,9 @@ For example, please find our [NIH-R24 Brain Initiative BIDS-Derivatives grant](h

A listing of the previous grants can be found [here](../collaboration/acknowledgments.md)

## Citing BIDS in your project
You can find information on citing BIDS standards for specific modalities and
citing BIDS in general
## Citing BIDS in your project
You can find information on citing BIDS standards for specific modalities and
citing BIDS in general
[in the specification](https://bids-specification.readthedocs.io/en/latest/introduction.html#citing-bids)

<!--
Expand Down
11 changes: 10 additions & 1 deletion md_link_check_config.json
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,16 @@
"pattern": "^https://www.instagram.com/bidsstandard.*"
},
{
"pattern": "^https://direct.mit.edu/imag/pages/editorial-info"
"pattern": "^https://direct.mit.edu/imag/.*"
},
{
"pattern": "^https://anaconda.org/conda-forge/bids-validator.*"
},
{
"pattern": "^https://www.openneuro.org.*"
},
{
"pattern": "^https://human-organ-atlas.esrf.eu.*"
}
],
"timeout": "20s",
Expand Down

0 comments on commit 9267247

Please sign in to comment.