Skip to content

BEP Process WG updates - #831

Draft
christinerogers wants to merge 10 commits into
bids-standard:mainfrom
ericearl:cr-bpwg-patch
Draft

BEP Process WG updates#831
christinerogers wants to merge 10 commits into
bids-standard:mainfrom
ericearl:cr-bpwg-patch

Conversation

@christinerogers

@christinerogers christinerogers commented Apr 22, 2026

Copy link
Copy Markdown
Contributor

First pass based on #770
WIP because committing to / referencing the visual BEP process roadmap breakdown would help this move forward with better clarity.

e.g. I added the BEP_idea layer in one diagram (to clarify when an idea becomes a draft and gets a BEP number).

If anything looks wonky, let me know for quick fixes


📚 Documentation preview 📚: https://bids-website--831.org.readthedocs.build/en/831/

@effigies effigies changed the title Cr bpwg patch BEP Process WG updates Apr 22, 2026
Comment thread docs/extensions/process.md Outdated
Comment thread docs/extensions/process.md Outdated
Comment thread docs/extensions/process.md Outdated
Comment thread docs/extensions/process.md Outdated
Comment thread docs/extensions/process.md Outdated
julia-pfarr and others added 2 commits May 22, 2026 13:57
@julia-pfarr
julia-pfarr marked this pull request as draft May 22, 2026 18:08
@julia-pfarr

Copy link
Copy Markdown
Member

I converted this PR to draft, once you have the visual overview ready we can convert back to open PR

@bendhouseart

Copy link
Copy Markdown
Contributor

Text reads fine to me @christinerogers, but I feel like I'm missing some context after reading @julia-pfarr 's last comment.

@bendhouseart
bendhouseart self-requested a review July 10, 2026 20:24

@bendhouseart bendhouseart left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Text is fine as mentioned and website looked okay assuming the mermaid charts get rendered later, they don't seem to correct on the preview. But, I realize we do a lot of weird stuff that might not get captured there

@ericearl

Copy link
Copy Markdown
Contributor

@julia-pfarr This diagram? (still in draft state, but nearing completion)

{27CAC007-D120-49DD-8766-BA51F877540B}

@julia-pfarr

julia-pfarr commented Jul 21, 2026

Copy link
Copy Markdown
Member

@julia-pfarr This diagram? (still in draft state, but nearing completion)

{27CAC007-D120-49DD-8766-BA51F877540B}

Yes, I think it would be worth waiting until this figure is complete and then updating all together with this PR. It should be done very soon, no? It was already almost done in Bordeaux...

A BEP transitions from one phase to another by passing a review process with the BIDS Maintainers. BEP contributors are welcome to join BIDS Maintainer meetings to schedule or discuss their BEP review status.
A BIDS Maintainer BEP steward, assigned during the BEP process, will actively guide each BEP team from the point of initial BEP idea review through the process outlined here, to provide feedback and guidance. Review discussions are typically followed with specific feedback on the relevant document (GitHub pull request or Google Doc), or by email if preferred by the BEP leads.

Please note the [community consultation requirements](FILL IN THE BLANK LINK) at each phase. BEP leads are encouraged to connect with the BIDS Maintainers in case of questions or challenges. The BIDS Maintainers are available to support discussions and facilitate convergence towards inclusive solutions for the BIDS community.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

can someone insert this link?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@ericearl the link here is still missing

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@julia-pfarr I think we should just remove that small sentence. I didn't readily see the "community consultation requirements" anywhere on the website, so I think it might have just been a not-completed idea from @christinerogers in April, left behind on accident. It doesn't lose any value to remove that sentence without a link.

@julia-pfarr

Copy link
Copy Markdown
Member

I think we should also mention the new BEP community meetings, wdyt? I'm presenting the plan to steering this Thursday and then we can publish it

@julia-pfarr

Copy link
Copy Markdown
Member

Text is fine as mentioned and website looked okay assuming the mermaid charts get rendered later, they don't seem to correct on the preview. But, I realize we do a lot of weird stuff that might not get captured there

Do we still need the mermaid diagram if we use the figure that Eric linked?

Comment thread docs/extensions/process.md Outdated
Comment on lines 189 to 192
In rare cases, it may be necessary to update:

- the BIDS validator to properly validate new content from a BEP;
- the BIDS website.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this really so rare? Maybe phrase it as these are deliverables that are done by the maintainers, the required deliverables are mainly responsibility of the BEP team

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@julia-pfarr Was this comment of yours addressed?

Comment thread docs/extensions/process.md Outdated
Comment thread docs/extensions/process.md Outdated
@ericearl

ericearl commented Aug 3, 2026

Copy link
Copy Markdown
Contributor

@neuromechanist @christinerogers @julia-pfarr

Just a self-reminder, these are website updates to reflect the current process, and as such I think we should get them in ASAP. The biggest action item here is a final draft of the "current" BEP Process Workflow Diagram, which is mostly complete, but needs one last look-over. Once we have that and include it in this PR, I think we're good here.

I think it would be worth waiting until this figure is complete and then updating all together with this PR. It should be done very soon, no? It was already almost done in Bordeaux...

I'll finish it off in the next 2-3 weeks.

I think we should also mention the new BEP community meetings, wdyt? I'm presenting the plan to steering this Thursday and then we can publish it

I think the new BEP community meetings announcement/site page should go in a separate PR.

Do we still need the mermaid diagram if we use the figure that Eric linked?

I think the mermaid charts are for different things, but the most essential thing is the colorful workflow diagram. Ignoring doing updates to the mermaid charts should be fine for this PR.

@ericearl

Copy link
Copy Markdown
Contributor

@christinerogers @julia-pfarr @bendhouseart How's this? I'm satisfied with this being the interim diagram until the new BEP process is established.

{FFDC9B13-3EF7-4B9F-BFEB-C7A1D25300C8}

@julia-pfarr

Copy link
Copy Markdown
Member

@ericearl do you want to wait for the feedback of the others or should I convert to "ready for review" and merge? Do you want more feedback after this draft PR was converted to "ready for review"?

@ericearl

ericearl commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

@julia-pfarr It looks like Mark made some suggestions that can be batched and committed here. After those are included, I think this PR's good to be reviewed/merged.

This is the current BEP process. It would be nice for it all to be present on the website instead of just what's there now.

@julia-pfarr julia-pfarr left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

apply suggestions from @markmikkelsen

julia-pfarr and others added 3 commits September 2, 2026 13:53
Co-authored-by: Mark Mikkelsen <mark.mikkelsen@gmail.com>
Co-authored-by: Eric Earl <eric.earl@nih.gov>
Co-authored-by: Mark Mikkelsen <mark.mikkelsen@gmail.com>
@neuromechanist

Copy link
Copy Markdown
Member

I think the mermaid charts are for different things, but the most essential thing is the colorful workflow diagram. Ignoring doing updates to the mermaid charts should be fine for this PR.

+10, I am independently moving away from them specially for public-facing materials.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants