Skip to content

Commit

Permalink
lint
Browse files Browse the repository at this point in the history
  • Loading branch information
Remi-Gau committed May 10, 2024
1 parent 85d6b3f commit 40a3815
Show file tree
Hide file tree
Showing 42 changed files with 610 additions and 400 deletions.
22 changes: 22 additions & 0 deletions docs/blog/posts/2020-03-12-steering-group-minutes.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,25 +44,47 @@ Regarding discussions on where to host our historical specification pdfs (please
## Minutes

- Discussed channels to share BIDS related information

- FreeSurfer, FSL, SPM, BIDS website-news

- Items to share

- 1.2.2 release

- [BEP018: Genetic information](https://github.com/bids-standard/bids-specification/pull/395)

- Do final call before merging into the standard

- Making the standard slide deck

- make it longer and presenter can slim down as needed

- Making repositories in BIDS standard

- 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/)

- Keeping it reasonable lenient

- Within README for repository

- identify at least 2-3 owners/maintainers of the repository

- Set a BIDS community forum and starter kit training in Open Science Room at OHBM

- Starter kit - running demos showing power of getting data into the BIDS ecosystem

- Zenodo for storing historical pdfs

- Pdfs need to be discoverable and persistent

- Add to previous language to BIDS website specification tab

- add a line pointing to Zenodo

- Add to release process

- adding pdf build to zenodo

- BIDS website start drop down menus extension
35 changes: 30 additions & 5 deletions docs/blog/posts/2020-03-23-steering-group-minutes.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,13 +12,27 @@ Attended: Franklin Feingold, Melanie Ganz, Guiomar Niso, Robert Oostenveld

## Executive Summary

We reviewed the action items from the previous two meetings. We discussed the framework for the BIDS community slides and how this information can be formatted and designed for future extensions and derived versions. We will draft an approach for organizing BIDS related meetings to pilot at NRM and OHBM in June.
We reviewed the action items from the previous two meetings.
We discussed the framework for the BIDS community slides and how this information can be formatted
and designed for future extensions and derived versions. We will draft an approach for organizing BIDS related meetings
to pilot at NRM and OHBM in June.

We also have a [list of channels](https://docs.google.com/spreadsheets/d/16SAGK3zG93WM2EWuoZDcRIC7ygPc5b7PDNGpFyC3obA/edit#gid=0) to share BIDS related information on. The have a plan for handling non-BIDS related information on our channels is to share on our [google group](https://groups.google.com/forum/#!forum/bids-discussion).
We also have a [list of channels](https://docs.google.com/spreadsheets/d/16SAGK3zG93WM2EWuoZDcRIC7ygPc5b7PDNGpFyC3obA/edit#gid=0)
to share BIDS related information on. The have a plan for handling non-BIDS related information on our channels
is to share on our [google group](https://groups.google.com/forum/#!forum/bids-discussion).

The attending members of the Steering Group gave approval for moving forward with completing the [Genetic Information BEP](https://github.com/bids-standard/bids-specification/pull/395). This will solidify the process for incorporating BEPs moving forward. The process will be: 1) merging in the BEP constructed examples to [BIDS-examples](https://github.com/bids-standard/bids-examples), 2) merge the validator extension into [BIDS-validator](https://github.com/bids-standard/bids-validator), and 3) merge the BEP into [BIDS-specification](https://github.com/bids-standard/bids-specification)
The attending members of the Steering Group gave approval for moving forward
with completing the [Genetic Information BEP](https://github.com/bids-standard/bids-specification/pull/395).
This will solidify the process for incorporating BEPs moving forward.

The Steering Group gave direction on handling author lists on Zenodo - make it a single author: “BIDS Contributors Group” as defined in the [governance document](https://docs.google.com/document/d/1R-J2lL9V_wIkYhye4zH-feyl4P4J8NyO40rIYyY141o/edit).
The process will be:

1. merging in the BEP constructed examples to [BIDS-examples](https://github.com/bids-standard/bids-examples)
1. merge the validator extension into [BIDS-validator](https://github.com/bids-standard/bids-validator), and
1. merge the BEP into [BIDS-specification](https://github.com/bids-standard/bids-specification)

The Steering Group gave direction on handling author lists on Zenodo - make it a single author:
“BIDS Contributors Group” as defined in the [governance document](https://docs.google.com/document/d/1R-J2lL9V_wIkYhye4zH-feyl4P4J8NyO40rIYyY141o/edit).

## Action Items

Expand All @@ -38,6 +52,7 @@ The Steering Group gave direction on handling author lists on Zenodo - make it a
- Reviewed [previous meeting action items](https://bids.neuroimaging.io/2020/03/12/Steering-Group-executive-summary,-action-items,-and-minutes.html#action-items)

- A [survey](https://docs.google.com/forms/d/e/1FAIpQLSfGjTA-U_1LECRsbuBQ9X7kdi34aEdxTMoWCwwkEgou-qpb4A/viewform) with an accompanying [blog post](https://bids.neuroimaging.io/2020/03/20/engage-with-the-bids-ecosystem.html) was drafted to evaluate how the community would like to engage with each other, what barriers may exist that makes engaging more challenging, and ways that we can engage colleagues that do not know about BIDS.

- Points to consider when designing the infrastructure to support BIDS slides

- An important feature is that the BIDS slides will be a living and breathing document shared via Google slides.
Expand All @@ -49,13 +64,23 @@ The Steering Group gave direction on handling author lists on Zenodo - make it a
- Compiling a [list of channels](https://docs.google.com/spreadsheets/d/16SAGK3zG93WM2EWuoZDcRIC7ygPc5b7PDNGpFyC3obA/edit#gid=0) to share BIDS news. Currently for version releases and community feedback calls on BEPs.

- Attending Steering Group members gave approval to move forward with finalizing the [Genetic Information extension](https://github.com/bids-standard/bids-specification/pull/395) and merging into the specification. This will trigger a [v1.3.0 release](https://github.com/bids-standard/bids-specification/pull/435) (according to our [release guidelines](https://github.com/bids-standard/bids-specification/blob/master/Release_Guideline.md)).
- For future BEPs, they will submit their examples to [BIDS-examples](https://github.com/bids-standard/bids-examples) for review by the Steering Group and confirm the [validator](https://github.com/bids-standard/bids-validator) has been extended properly. The BEP leads can leave it as a draft PR. It was determined that opening the PR from a branch of the [BIDS specification repository](https://github.com/bids-standard/bids-specification) should be done allowing us to render the extension via ReadTheDocs.

- For future BEPs, they will submit their examples to [BIDS-examples](https://github.com/bids-standard/bids-examples)
for review by the Steering Group and confirm the [validator](https://github.com/bids-standard/bids-validator) has been extended properly.
The BEP leads can leave it as a draft PR.
It was determined that opening the PR from a branch of the [BIDS specification repository](https://github.com/bids-standard/bids-specification)
should be done allowing us to render the extension via ReadTheDocs.

- 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)”.

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

- The Steering Group discussed where to share non-BIDS related information.

- The consensus was to share on the [bids-discussion](https://groups.google.com/forum/#!forum/bids-discussion) Google group channel.

- We brainstormed what may be the related initiatives to keep aware of. FF contacted INCF to see if they have information regarding this. Please see the [INCF blog](https://www.incf.org/blogs-list).

- The Steering Group discussed the format for the BIDS Maintainers monthly update. This will be submitted to Slack and added to the next agenda. This will be implemented starting with the March update and will not be retroactive.
17 changes: 15 additions & 2 deletions docs/blog/posts/2020-03-30-steering-group-minutes.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,9 +10,15 @@ categories:

## Executive Summary

We discussed how to move forward with implementing the author lists on [Zenodo](https://zenodo.org/record/3686062) from our pdf specification. We want to provide guidance on how we landed on our decision: a single author “BIDS Contributing Group”. This will be opened as a proposal with a request for comments (RFC) on the [BIDS-Specification repository](https://github.com/bids-standard/bids-specification). This is important to deploy with the community’s approval. This may give way for a stronger contributor tracking system.
We discussed how to move forward with implementing the author lists on [Zenodo](https://zenodo.org/record/3686062) from our pdf specification.
We want to provide guidance on how we landed on our decision: a single author “BIDS Contributing Group”.
This will be opened as a proposal with a request for comments (RFC) on the [BIDS-Specification repository](https://github.com/bids-standard/bids-specification).
This is important to deploy with the community’s approval. This may give way for a stronger contributor tracking system.

We clarified the format and points for the monthly Maintainers update. This should be less than 1 page and keep a high level view of BIDS. The executive summary must include: achievements, struggles, next month aims, blockers or steering group help. The update may also link to issues with a 1 sentence narrative. Keeping in mind the purpose of the update from the Steering Group’s perspective: knowing the hard parts or blockers and capture the work needed to maintain BIDS.
We clarified the format and points for the monthly Maintainers update.
This should be less than 1 page and keep a high level view of BIDS. The executive summary must include: achievements, struggles, next month aims, blockers or steering group help.
The update may also link to issues with a 1 sentence narrative.
Keeping in mind the purpose of the update from the Steering Group’s perspective: knowing the hard parts or blockers and capture the work needed to maintain BIDS.

We invited the [ASL BEP](https://bids.neuroimaging.io/bep005) leads to the next Steering Group meeting.

Expand All @@ -32,17 +38,24 @@ We invited the [ASL BEP](https://bids.neuroimaging.io/bep005) leads to the next
- We discussed the author lists on Zenodo for our specification pdfs.

- Strike the difference between authorship on BIDS publications versus on Zenodo. Provide a guidance that is respectful and appreciative to our BIDS contributors.

- Perhaps highlight those who were the contributors of a particular release while preserving the entire contributor list for every version regardless of how old the contribution was. (i.e. not removing authors)

- Provides room to propose an update to our contributor system.

- KW Drafting a recommendation proposal to the BIDS community

- Clarifications were discussed regarding the Maintainers update

- Less than 1page, high level, 1 sentence for an issue (as needed)

- Update covers action of the last month: achievements, struggles, next month outlook, and blocking items.

- The blocking items may be most important for Steering Group to be aware of.
- Link to the issues on GitHub

- This update will provide strong historical perspective

- Keep in mind the purpose of the update: The Steering Group wants to capture the work performed to maintain BIDS and what are the hard parts/blockers of the project.

- Addressing issues related to lowering the barriers to contribute to BIDS.
Expand Down
6 changes: 5 additions & 1 deletion docs/blog/posts/2020-04-16-steering-group-minutes.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,11 @@ categories:

## Executive Summary

We were joined in this meeting by the BIDS-ASL BEP leads. We spent the majority of this meeting discussing the [BIDS-ASL](https://bids.neuroimaging.io/bep005) BEP development approach and status along with any open questions they may have. We see a natural integration between the [ASL](https://bids.neuroimaging.io/bep005) and [PET](https://bids.neuroimaging.io/bep009) BEP projects. While talking to the ASL team we found that our definition of `raw` needs to be refined and made more specific. We want to ensure that fields previously specified remain consistent, when possible. Once the raw ASL specification is merged the group will move forward with derivatives.
We were joined in this meeting by the BIDS-ASL BEP leads.
We spent the majority of this meeting discussing the [BIDS-ASL](https://bids.neuroimaging.io/bep005) BEP development approach and status along with any open questions they may have.
We see a natural integration between the [ASL](https://bids.neuroimaging.io/bep005) and [PET](https://bids.neuroimaging.io/bep009) BEP projects.
While talking to the ASL team we found that our definition of `raw` needs to be refined and made more specific.
We want to ensure that fields previously specified remain consistent, when possible. Once the raw ASL specification is merged the group will move forward with derivatives.

## Action Items

Expand Down
47 changes: 37 additions & 10 deletions docs/blog/posts/2020-05-07-steering-group-minutes.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,13 +10,30 @@ categories:

## Executive Summary

We held a joint Steering Group - Maintainers Group meeting to primarily present and discuss recent Maintenance activities. It is crucial to provide opportunities for these two groups to come closer together.

We began by discussing a proposal for how to handle [Zenodo author lists](https://github.com/bids-standard/bids-specification/issues/66). It is important to recognize diverse contributions. The proposal will be calling for two different groups: authors and contributors. An author could be one who pushes substantial contributions or those that regularly answer questions. The key is for these to be sustained expertise contributions. The author order will be alphabetical and an author cannot be removed from the list. We will also support an author section in the specification appendix that can specifically identify their contributions to the project. This can include contributors too. The author section may include the potential for a paragraph (max) narrative of contributions. This will be enhancing our current emoji representation of contributions. This will give the community more opportunity to capture their specific contributions to BIDS.

We accepted three new BEPs: [Provenance](https://bids.neuroimaging.io/bep028), [Virtual and physical motion data](https://bids.neuroimaging.io/bep029), and [Near-Infrared Spectroscopy](https://bids.neuroimaging.io/bep030). These have been added to the website. We primarily evaluated the scope and if this is a duplicated effort. It is important for BEPs to signal community engagement and buy-in for their extension proposal from the respective modality community.

We will be enhancing our [definition of a Maintainer](https://github.com/bids-standard/bids-specification/pull/467) to include a domain they are responsible for maintaining. This will enable more pathways into the Maintainers Group while promoting more diverse contributions. It will additionally build in more resilience and sustainability into our community. This will further clarify the Maintainers role and give more specific responsibilities to a Maintainer. These domains will be proposed and accepted within the Maintainers Group.
We held a joint Steering Group - Maintainers Group meeting to primarily present and discuss recent Maintenance activities.
It is crucial to provide opportunities for these two groups to come closer together.

We began by discussing a proposal for how to handle [Zenodo author lists](https://github.com/bids-standard/bids-specification/issues/66).
It is important to recognize diverse contributions.
The proposal will be calling for two different groups: authors and contributors.
An author could be one who pushes substantial contributions or those that regularly answer questions.
The key is for these to be sustained expertise contributions.
The author order will be alphabetical and an author cannot be removed from the list.
We will also support an author section in the specification appendix that can specifically identify their contributions to the project.
This can include contributors too.
The author section may include the potential for a paragraph (max) narrative of contributions.
This will be enhancing our current emoji representation of contributions.
This will give the community more opportunity to capture their specific contributions to BIDS.

We accepted three new BEPs: [Provenance](https://bids.neuroimaging.io/bep028), [Virtual and physical motion data](https://bids.neuroimaging.io/bep029), and [Near-Infrared Spectroscopy](https://bids.neuroimaging.io/bep030).
These have been added to the website. We primarily evaluated the scope and if this is a duplicated effort.
It is important for BEPs to signal community engagement and buy-in for their extension proposal from the respective modality community.

We will be enhancing our [definition of a Maintainer](https://github.com/bids-standard/bids-specification/pull/467) to include a domain they are responsible for maintaining.
This will enable more pathways into the Maintainers Group while promoting more diverse contributions.
It will additionally build in more resilience and sustainability into our community.
This will further clarify the Maintainers role and give more specific responsibilities to a Maintainer.
These domains will be proposed and accepted within the Maintainers Group.

## Action Items

Expand All @@ -31,33 +48,43 @@ We will be enhancing our [definition of a Maintainer](https://github.com/bids-st
This was a joint meeting between the Steering Group and Maintainers Group to go over recent BIDS Maintenance activities and bring these two groups closer together.

- [Zenodo author lists](https://github.com/bids-standard/bids-specification/issues/66)

- Recognizing diverse contributions
- Author: sustained substantial contributions, regularly answering questions
- Contributor is more flexible

- Alphabetical order and the author list can only be added to not removed

- Proposal to add an author’s and contributor’s page to the appendix of the specification

- Add more details of the specific contribution to BIDS
- Can be up to a paragraph narrative

- The goal is to list and give more credit to contributors

- This can also be hosted on GitHub
- Perhaps GitHub Wiki

- Accepted BEPs

- [BEP028: Provenance](https://bids.neuroimaging.io/bep028)
- [BEP029: Virtual and physical motion data](https://bids.neuroimaging.io/bep029)
- [BEP030: Near-Infrared Spectroscopy](https://bids.neuroimaging.io/bep030)
- [BEP028: Provenance](https://bids.neuroimaging.io/bep028)
- [BEP029: Virtual and physical motion data](https://bids.neuroimaging.io/bep029)
- [BEP030: Near-Infrared Spectroscopy](https://bids.neuroimaging.io/bep030)

- Steering Group review consists primarily of ensuring it is within scope and not duplicating efforts

- BEPs need to signal they have gotten community buy-in

- MG potentially hosting a PET virtual workshop around OHBM

- Pushing the [Starter Kit repository](https://github.com/bids-standard/bids-starter-kit)

- [Enhancing our definition of a Maintainer](https://github.com/bids-standard/bids-specification/pull/467)

- Adding a specialty or domain expert responsibility to the role
- Workshopping the semantics
- Gives more clarity and specificity to the responsibilities of the role

- The goal is to nurture more diverse contributions and build in more resilience and sustainability into the organization

- This will be managed by the Maintainers Group
Loading

0 comments on commit 40a3815

Please sign in to comment.