diff --git a/data/working_groups.yml b/data/working_groups.yml new file mode 100644 index 00000000..76e38838 --- /dev/null +++ b/data/working_groups.yml @@ -0,0 +1,76 @@ +--- +# template +# - title: +# goal: +# open_letter: +# communication_channel: +# url: +# chairs: +# - name: +# email: +# - name: +# email: +# status: +# outcome: +# - url: +# - url: +# + +# 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: +# email: +# status: active + +- title: Code of conducts amendments + goal: Update and uniformizations of the BIDS code of conducts + open_letter: https://docs.google.com/document/d/1mxtijf1khONdU23phKfMpIwk-RTDQ07eVpJsMHemoLA/edit + communication_channel: TBD + url: https://docs.google.com/document/d/1Cj9trFifGNqyNtpyEO9FfJLlmDGTbUy5enRAA9rTyH4/edit?usp=sharing + chairs: + - 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: https://docs.google.com/document/d/1lN9hu5ufpkkkD41XXWrH_tnEXlKUlJaZNQBYF3OtV9M/edit?usp=sharing + communication_channel: TBD + url: + chairs: + - 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: + 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: '[Pull request](https://github.com/bids-standard/bids-website/pull/346)' diff --git a/docs/collaboration/governance.md b/docs/collaboration/governance.md index 217d301f..09118ee8 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..3509106f --- /dev/null +++ b/docs/collaboration/working-groups.md @@ -0,0 +1,21 @@ +# 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 + +{{ 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/docs/contact/index.md b/docs/contact/index.md index 16691d63..b879540a 100644 --- a/docs/contact/index.md +++ b/docs/contact/index.md @@ -51,8 +51,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/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", ] diff --git a/macros/macros.py b/macros/macros.py index caf91427..d577db20 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/mkdocs.yml b/mkdocs.yml index 17a7a796..143c4ef7 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -182,6 +182,7 @@ nav: - collaboration/index.md - specification/code_of_conduct.md - collaboration/governance.md + - collaboration/working-groups.md - collaboration/contributors.md - collaboration/acknowledgments.md # TODO have a single code of conduct 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 %}