From 43739827e6e9116e39e71ad4f563e091c0014f75 Mon Sep 17 00:00:00 2001 From: Remi Gau Date: Fri, 26 Jul 2024 15:32:52 +0200 Subject: [PATCH 1/7] start adding working group --- data/working_groups.yml | 75 ++++++++++++++++++++++++++++ docs/collaboration/governance.md | 29 +++++------ docs/collaboration/working_groups.md | 16 ++++++ docs/contact.md | 4 +- mkdocs.yml | 1 + 5 files changed, 109 insertions(+), 16 deletions(-) create mode 100644 data/working_groups.yml create mode 100644 docs/collaboration/working_groups.md diff --git a/data/working_groups.yml b/data/working_groups.yml new file mode 100644 index 00000000..b52f190f --- /dev/null +++ b/data/working_groups.yml @@ -0,0 +1,75 @@ +--- +# template +# - title: +# goal: +# open-letter: +# communication-channel: +# link: +# leads: +# - name: +# email: +# - name: +# email: +# status: +# outcome: +# - url: +# - url: +# + +# ACTIVE + +- title: BIDS 2.0 + goal: ??? + open-letter: TBD + communication-channel: TBD + link: https://github.com/bids-standard/bids-2-devel + leads: + - name: Yaroslav Halchenko + - email: debian@onerussian.com + status: active + +- title: Governance amendments + goal: Clarification of the BEP process + open-letter: TBD + communication-channel: TBD + link: TBD + leads: + - name: Ariel Rokem + email: arokem@uw.edu + status: active + +- title: Code of conducts amendments + goal: Update and uniformizations of the BIDS code of conducts + open-letter: TBD + communication-channel: TBD + link: TBD + leads: + - name: Rémi Gau + email: remi.gau@gmail.com + status: active + +- title: BIDS online presence + goal: Streamline online resources based on community feedback + open-letter: TBD + communication-channel: TBD + link: TBD + leads: + - name: Eric Earl + email: eric.earl@nih.gov + - name: Christine Rogers + email: rogers@bic.mni.mcgill.ca + status: active + +# DISSOLVED + +- title: Governance amendment + goal: Update the BIDS governance + open-letter: https://docs.google.com/document/d/18PpfSgcHckqejTZsRZlEDlJ_yD3JiwSQ8kCjVXorg6U/edit#heading=h.6tz42cdj5asc + communication-channel: + link: https://docs.google.com/document/d/18PpfSgcHckqejTZsRZlEDlJ_yD3JiwSQ8kCjVXorg6U/edit#heading=h.6tz42cdj5asc + leads: + - name: Rémi Gau + email: remi.gau@gmail.com + status: dissolved + outcome: + - url: https://github.com/bids-standard/bids-website/pull/346 diff --git a/docs/collaboration/governance.md b/docs/collaboration/governance.md index 9a8c4055..a8cb3657 100644 --- a/docs/collaboration/governance.md +++ b/docs/collaboration/governance.md @@ -224,20 +224,21 @@ they should inform the steering group in advance and are responsible to help: ### Other working/interest Groups -A working/interest group can be established under the approval of the -BIDS Steering Group. This is typically but not limited to being formed -for the purpose of advancing the BIDS community, not the standard. Each -group will appoint 1-2 chairs. Members of these groups can have cross -appointments in other groups (for example, BEP Working Group). These groups do -not necessarily dissolve after some duration or event, unless stated in -their proposal. - -The working/interest group formation is formalized through an open -letter via a "read-only" Google Document addressed to the BIDS Steering -Group. The open letter will be posted on: -the [BIDS-Specification GitHub repository](https://github.com/bids-standard/bids-specification), -[Google Group](https://groups.google.com/forum/#!forum/bids-discussion), -and [social media channels](). +A working/interest group can be established under the approval of the BIDS Steering Group. +This is typically but not limited to being formed for the purpose of advancing the BIDS community, not the standard. + +Each group will appoint 1-2 chairs. +Members of these groups can have cross appointments in other groups (for example, BEP Working Group). +These groups do not necessarily dissolve after some duration or event, unless stated in their proposal. + +The working/interest group formation is formalized +through an open letter via a "read-only" Google Document addressed to the BIDS Steering Group. +The open letter will be posted on: + +- the [BIDS-Specification GitHub repository](https://github.com/bids-standard/bids-specification), +- [Google Group](https://groups.google.com/forum/#!forum/bids-discussion), +- and [social media channels](). + This proposal will state what their group aims and goals are. ### BIDS Community diff --git a/docs/collaboration/working_groups.md b/docs/collaboration/working_groups.md new file mode 100644 index 00000000..a1512be3 --- /dev/null +++ b/docs/collaboration/working_groups.md @@ -0,0 +1,16 @@ +# BIDS Working groups + +BIDS working groups are typically formed (but not limited to) +for the purpose of advancing the BIDS community, not the standard. + +This could be a to set up and organize a local BIDS chapter, to improve the documentation around BIDS... + +## Forming a working group + +The rules to form a working group are mentioned in the [governance](./governance.md#other-workinginterest-groups). + +A template for the open-letter can be found in [this google doc](https://docs.google.com/document/d/1JfTliUcpyRAGdiZSHObkvZFdkrxPTclQTvolr8ssNHM/edit) + +## Active working groups + +## Past working groups diff --git a/docs/contact.md b/docs/contact.md index 523d4fe0..f0e9cd74 100644 --- a/docs/contact.md +++ b/docs/contact.md @@ -57,8 +57,8 @@ Some example questions that have already been answered include: - [:simple-bluesky: Bluesky](https://bsky.app/profile/bidsstandard.bsky.social/) - [:simple-mastodon: Mastodon](https://fosstodon.org/@bidsstandard/) - - [:simple-x: Twitter/ X](https://x.com/BIDSstandard) - - [:simple-youtube: YouTube](https://www.youtube.com/embed/-c4PUhTwmz4) + - [:simple-x: Twitter / X](https://x.com/BIDSstandard) + - [:simple-youtube: YouTube](https://www.youtube.com/channel/UCxZUcYfd_nvIVWAbzRB1tlw) - [:simple-instagram: Instagram](https://www.instagram.com/bidsstandard) - Listen to our [podcast](https://anchor.fm/bids-maintenance) diff --git a/mkdocs.yml b/mkdocs.yml index b8142061..5321cbfd 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -184,6 +184,7 @@ nav: - Others: tools/others.md - Collaboration: - Governance: collaboration/governance.md + - Working groups: collaboration/working_groups.md - Code of conduct: specification/CODE_OF_CONDUCT.md # TODO have a single code of conduct From d68c8550fbd8c48bda628b19a9ab0516a2d52935 Mon Sep 17 00:00:00 2001 From: Remi Gau Date: Fri, 26 Jul 2024 16:01:22 +0200 Subject: [PATCH 2/7] render tables --- data/working_groups.yml | 55 +++++++++++++------------- docs/collaboration/working_groups.md | 6 ++- macros/macros.py | 8 ++++ macros/main.py | 4 ++ templates/working_group_table_md.jinja | 12 ++++++ 5 files changed, 56 insertions(+), 29 deletions(-) create mode 100644 templates/working_group_table_md.jinja diff --git a/data/working_groups.yml b/data/working_groups.yml index b52f190f..e4b66e26 100644 --- a/data/working_groups.yml +++ b/data/working_groups.yml @@ -2,10 +2,10 @@ # template # - title: # goal: -# open-letter: -# communication-channel: -# link: -# leads: +# open_letter: +# communication_channel: +# url: +# chairs: # - name: # email: # - name: @@ -19,41 +19,41 @@ # ACTIVE - title: BIDS 2.0 - goal: ??? - open-letter: TBD - communication-channel: TBD - link: https://github.com/bids-standard/bids-2-devel - leads: + goal: Discussions and suggestions of backwards incompatible changes to BIDS + open_letter: TBD + communication_channel: TBD + url: https://github.com/bids-standard/bids-2-devel + chairs: - name: Yaroslav Halchenko - - email: debian@onerussian.com + email: debian@onerussian.com status: active - title: Governance amendments goal: Clarification of the BEP process - open-letter: TBD - communication-channel: TBD - link: TBD - leads: + open_letter: TBD + communication_channel: TBD + url: + chairs: - name: Ariel Rokem email: arokem@uw.edu status: active - title: Code of conducts amendments goal: Update and uniformizations of the BIDS code of conducts - open-letter: TBD - communication-channel: TBD - link: TBD - leads: + open_letter: TBD + communication_channel: TBD + url: + chairs: - name: Rémi Gau email: remi.gau@gmail.com status: active - title: BIDS online presence goal: Streamline online resources based on community feedback - open-letter: TBD - communication-channel: TBD - link: TBD - leads: + open_letter: TBD + communication_channel: TBD + url: + chairs: - name: Eric Earl email: eric.earl@nih.gov - name: Christine Rogers @@ -64,12 +64,11 @@ - title: Governance amendment goal: Update the BIDS governance - open-letter: https://docs.google.com/document/d/18PpfSgcHckqejTZsRZlEDlJ_yD3JiwSQ8kCjVXorg6U/edit#heading=h.6tz42cdj5asc - communication-channel: - link: https://docs.google.com/document/d/18PpfSgcHckqejTZsRZlEDlJ_yD3JiwSQ8kCjVXorg6U/edit#heading=h.6tz42cdj5asc - leads: + open_letter: https://docs.google.com/document/d/18PpfSgcHckqejTZsRZlEDlJ_yD3JiwSQ8kCjVXorg6U/edit#heading=h.6tz42cdj5asc + communication_channel: + url: https://docs.google.com/document/d/18PpfSgcHckqejTZsRZlEDlJ_yD3JiwSQ8kCjVXorg6U/edit#heading=h.6tz42cdj5asc + chairs: - name: Rémi Gau email: remi.gau@gmail.com status: dissolved - outcome: - - url: https://github.com/bids-standard/bids-website/pull/346 + outcome: '[Pull request](https://github.com/bids-standard/bids-website/pull/346)' diff --git a/docs/collaboration/working_groups.md b/docs/collaboration/working_groups.md index a1512be3..c22bd00c 100644 --- a/docs/collaboration/working_groups.md +++ b/docs/collaboration/working_groups.md @@ -9,8 +9,12 @@ This could be a to set up and organize a local BIDS chapter, to improve the docu The rules to form a working group are mentioned in the [governance](./governance.md#other-workinginterest-groups). -A template for the open-letter can be found in [this google doc](https://docs.google.com/document/d/1JfTliUcpyRAGdiZSHObkvZFdkrxPTclQTvolr8ssNHM/edit) +A template for the open-letter can be found in [this google doc](https://docs.google.com/document/d/1JfTliUcpyRAGdiZSHObkvZFdkrxPTclQTvolr8ssNHM/edit). ## Active working groups +{{ MACROS___generate_working_groups_table(file="working_groups.yml", status="active") }} + ## Past working groups + +{{ MACROS___generate_working_groups_table(file="working_groups.yml", status="dissolved") }} diff --git a/macros/macros.py b/macros/macros.py index 9154c25a..2ff4f731 100644 --- a/macros/macros.py +++ b/macros/macros.py @@ -54,6 +54,14 @@ def generate_beps_table(file: str, type: str | None = None) -> str: return template.render(include=content, type=type) +def generate_working_groups_table(file: str, status: str | None = None) -> str: + input_file = WEBSITE_DATA_DIR / file + content = yaml.load(input_file) + env = return_jinja_env() + template = env.get_template("working_group_table_md.jinja") + return template.render(include=content, status=status) + + def generate_grants_table(): input_file = WEBSITE_DATA_DIR / "grants.yml" content = yaml.load(input_file) diff --git a/macros/main.py b/macros/main.py index c4dde222..c1df7341 100644 --- a/macros/main.py +++ b/macros/main.py @@ -37,3 +37,7 @@ def define_env(env): env.macro(macros.generate_beps_table, "MACROS___generate_beps_table") env.macro(macros.generate_grants_table, "MACROS___generate_grants_table") env.macro(macros.generate_apps_table, "MACROS___generate_apps_table") + env.macro( + macros.generate_working_groups_table, + "MACROS___generate_working_groups_table", + ) diff --git a/templates/working_group_table_md.jinja b/templates/working_group_table_md.jinja new file mode 100644 index 00000000..7cfd640e --- /dev/null +++ b/templates/working_group_table_md.jinja @@ -0,0 +1,12 @@ +{% if status == "dissolved" %} +| Name | Goal | Lead(s) | Outcome | +| :---: | :---- | :------ | :------ | +{% else %} +| Name | Goal | Lead(s) | communication channel | +| :---: | :---- | :---- | :-------------------- | +{% endif %} +{% for group in include %} +{% if group.status == status %} +| [{{ group.title }}]({{ group.url }}) | {{ group.goal }} | {% for person in group.chairs %} {% if person.email %} [{{ person.name }}](mailto:{{ person.email }}) {% else %} {{ person.name }} {% endif %}
{% endfor %} | {% if status == "dissolved" %} {{ group.outcome }} {% else %} {{ group.communication_channel }} {% endif %} | +{% endif %} +{% endfor %} From ce15f2e8b35af87f0305976e25449cb97107b2b0 Mon Sep 17 00:00:00 2001 From: Remi Gau Date: Fri, 26 Jul 2024 16:34:33 +0200 Subject: [PATCH 3/7] fix filename --- docs/blog/posts/town-hall-2024.md | 21 +++++++++++++++++++++ mkdocs.yml | 2 +- 2 files changed, 22 insertions(+), 1 deletion(-) create mode 100644 docs/blog/posts/town-hall-2024.md diff --git a/docs/blog/posts/town-hall-2024.md b/docs/blog/posts/town-hall-2024.md new file mode 100644 index 00000000..bad5ad93 --- /dev/null +++ b/docs/blog/posts/town-hall-2024.md @@ -0,0 +1,21 @@ +--- +date: 2024-07-01 +slug: BIDS Town Hall 2024 +author: Rémi Gau +categories: +- town hall +--- + +Are you interested in learning more about how the BIDS initiative is developing or sharing your feedback with the BIDS team? + + + +Come check out our BIDS Town Hall happening at OHBM in the [Open Science Room](https://ohbm.github.io/osr2022/) on Monday June 20 at 10:30am BST / 11:30am CEST / 5:30am ET to hear more about our organizational updates, status updates from several of our BIDS extension proposal (BEP) leads, our community projects, and an opportunity to voice your thoughts about the organizational direction! + +To virtually attend, please register on the [open science room website](https://ohbm.github.io/osr2022/register/). + +For those attending OHBM in-person - See you there! + +Please feel free to reach out to Franklin with any questions. + +See you then! diff --git a/mkdocs.yml b/mkdocs.yml index 5321cbfd..8a6369d9 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -184,7 +184,7 @@ nav: - Others: tools/others.md - Collaboration: - Governance: collaboration/governance.md - - Working groups: collaboration/working_groups.md + - Working groups: collaboration/working-groups.md - Code of conduct: specification/CODE_OF_CONDUCT.md # TODO have a single code of conduct From f4283dd12c379c36332f8810fd25f428f571dcf9 Mon Sep 17 00:00:00 2001 From: Remi Gau Date: Fri, 26 Jul 2024 16:42:43 +0200 Subject: [PATCH 4/7] rm blog post --- docs/blog/posts/town-hall-2024.md | 21 --------------------- 1 file changed, 21 deletions(-) delete mode 100644 docs/blog/posts/town-hall-2024.md diff --git a/docs/blog/posts/town-hall-2024.md b/docs/blog/posts/town-hall-2024.md deleted file mode 100644 index bad5ad93..00000000 --- a/docs/blog/posts/town-hall-2024.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -date: 2024-07-01 -slug: BIDS Town Hall 2024 -author: Rémi Gau -categories: -- town hall ---- - -Are you interested in learning more about how the BIDS initiative is developing or sharing your feedback with the BIDS team? - - - -Come check out our BIDS Town Hall happening at OHBM in the [Open Science Room](https://ohbm.github.io/osr2022/) on Monday June 20 at 10:30am BST / 11:30am CEST / 5:30am ET to hear more about our organizational updates, status updates from several of our BIDS extension proposal (BEP) leads, our community projects, and an opportunity to voice your thoughts about the organizational direction! - -To virtually attend, please register on the [open science room website](https://ohbm.github.io/osr2022/register/). - -For those attending OHBM in-person - See you there! - -Please feel free to reach out to Franklin with any questions. - -See you then! From 64e28dc61f7796272d57037523ee0643e97dde2e Mon Sep 17 00:00:00 2001 From: Remi Gau Date: Sat, 28 Sep 2024 12:25:12 +0000 Subject: [PATCH 5/7] update links working groups --- data/working_groups.yml | 48 +++++++++++++++++++++-------------------- 1 file changed, 25 insertions(+), 23 deletions(-) diff --git a/data/working_groups.yml b/data/working_groups.yml index e4b66e26..76e38838 100644 --- a/data/working_groups.yml +++ b/data/working_groups.yml @@ -18,39 +18,41 @@ # ACTIVE -- title: BIDS 2.0 - goal: Discussions and suggestions of backwards incompatible changes to BIDS - open_letter: TBD - communication_channel: TBD - url: https://github.com/bids-standard/bids-2-devel - chairs: - - name: Yaroslav Halchenko - email: debian@onerussian.com - status: active +# - title: BIDS 2.0 +# goal: Discussions and suggestions of backwards incompatible changes to BIDS +# open_letter: TBD +# communication_channel: TBD +# url: https://github.com/bids-standard/bids-2-devel +# chairs: +# - name: Yaroslav Halchenko +# email: debian@onerussian.com +# status: active -- title: Governance amendments - goal: Clarification of the BEP process - open_letter: TBD - communication_channel: TBD - url: - chairs: - - name: Ariel Rokem - email: arokem@uw.edu - status: active +# - title: Governance amendments +# goal: Clarification of the BEP process +# open_letter: TBD +# communication_channel: TBD +# url: +# chairs: +# - name: +# email: +# status: active - title: Code of conducts amendments goal: Update and uniformizations of the BIDS code of conducts - open_letter: TBD + open_letter: https://docs.google.com/document/d/1mxtijf1khONdU23phKfMpIwk-RTDQ07eVpJsMHemoLA/edit communication_channel: TBD - url: + url: https://docs.google.com/document/d/1Cj9trFifGNqyNtpyEO9FfJLlmDGTbUy5enRAA9rTyH4/edit?usp=sharing chairs: - - name: Rémi Gau - email: remi.gau@gmail.com + - name: Ariel Rokem + email: arokem@uw.edu + - name: Dora Hermes + email: doraharmes@gmail.com status: active - title: BIDS online presence goal: Streamline online resources based on community feedback - open_letter: TBD + open_letter: https://docs.google.com/document/d/1lN9hu5ufpkkkD41XXWrH_tnEXlKUlJaZNQBYF3OtV9M/edit?usp=sharing communication_channel: TBD url: chairs: From f6a609915f32ac46dcd59deac65f3eea2b4df5c7 Mon Sep 17 00:00:00 2001 From: Remi Gau Date: Sat, 28 Sep 2024 12:29:44 +0000 Subject: [PATCH 6/7] fix import --- docs/collaboration/working_groups.md | 3 ++- macros/__init__.py | 2 ++ 2 files changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/collaboration/working_groups.md b/docs/collaboration/working_groups.md index c22bd00c..3509106f 100644 --- a/docs/collaboration/working_groups.md +++ b/docs/collaboration/working_groups.md @@ -3,7 +3,8 @@ BIDS working groups are typically formed (but not limited to) for the purpose of advancing the BIDS community, not the standard. -This could be a to set up and organize a local BIDS chapter, to improve the documentation around BIDS... +This could be a to set up and organize a local BIDS chapter, +to improve the documentation around BIDS... ## Forming a working group diff --git a/macros/__init__.py b/macros/__init__.py index bba81812..aa4ae476 100644 --- a/macros/__init__.py +++ b/macros/__init__.py @@ -5,6 +5,7 @@ generate_grants_table, generate_members_table, generate_tools_table, + generate_working_groups_table, ) from .main import define_env @@ -16,4 +17,5 @@ "generate_beps_table", "generate_grants_table", "generate_apps_table", + "generate_working_groups_table", ] From fa6cd3c5296a51c482f65fefe054741c278d1f3d Mon Sep 17 00:00:00 2001 From: Remi Gau Date: Sat, 28 Sep 2024 12:37:55 +0000 Subject: [PATCH 7/7] rename --- docs/collaboration/{working_groups.md => working-groups.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename docs/collaboration/{working_groups.md => working-groups.md} (100%) diff --git a/docs/collaboration/working_groups.md b/docs/collaboration/working-groups.md similarity index 100% rename from docs/collaboration/working_groups.md rename to docs/collaboration/working-groups.md