Skip to content

Finalise governance docs - resolve outstanding queries#23

Open
RayStick wants to merge 15 commits into
masterfrom
finalise
Open

Finalise governance docs - resolve outstanding queries#23
RayStick wants to merge 15 commits into
masterfrom
finalise

Conversation

@RayStick

@RayStick RayStick commented Feb 10, 2026

Copy link
Copy Markdown
Member

Closes #3

Closes #22

Summary

Hi all, please see changes I have made to try to finalise outstanding queries we had logged, relating to the governance docs. Please note, we should avoid editing this CHARTER.md regularly, so if you think any more edits need to be done to it, let's do it in this branch. For example, #22?

In the Charter it says -

Amendments to this charter, the trademark policy, or the code of conduct may only be made with at least a 3/4 affirmative vote of the active community members.

So after we've agreed on these edits, we need to offer the changes out to all community members.

Itemised list

  1. Write definition of what 'actively involved in a project' means

✅ I attempted this here - 5639775 and 9015984
@goodalse2019 you gave a nice description here but I think that should make its way into documentation specific project docs :)


  1. Do we want to create embargo rules? To be considered with values of inclusivity, non-hierarchical governance, longevity - how to encourage turnover?

✅ I think what this is getting at is that we don't say someone has to leave after X number of years, or someone has to wait X number of months/years in between successive 'terms'. I don't think this is necessary for our community right now so I suggest we leave this term wording as it is - b1b9b4c


  1. Get community’s view on the choice of this license. Provide a clear rationale on any choice - a single license has been chosen to avoid conflicts of licenses across the organisation, but could be seen as too specific for some contributors

✅ I think the words "or maintainers of the project can request a different license, to be approved by the Steering Committe" are sufficient - c3bb932


  1. Populate this section ( ## 10. Contribution Recognition and Authorship) noting that we already have some norms documents on the website/contributor’s guide, including all-contributors, alphabetical ordering etc.

✅ Gave it a go here, using text from other places - 27aadb9


  1. Modify to reflect both software and documentation projects and generally check - physiopy-governance/org-docs/TRADEMARKS.md

✅ On second reading, I think this is fine. I don't want to edit this too much because I think it is carefully written. If people have suggested changes on how to capture more documentation type projects in these trademarks, let me know, but I think it's general enough to be okay. b915265


  1. CODE-OF-CONDUCT.md. - This doesn't currently exist in the repo but needs to be added, likely based on but update from our website Code of Conduct (here) - which should then be linked to the governance repo, I think. In general maybe there's a nicer way to link the governance files in this repo to our website to figure out!

❓ The Code of Conduct in this goverance repo appears to match the one on our website, except the contact details.

  • ❓would it be good to have one place that we store this code of conduct file (this repo?) and then we link to it? Then if changes are made, they are only in one place perhaps. For example, currently the code of conduct is stored here, website and at the level of each individual repo (e.g. phys2bids)
  • ❓ is it in agreement/harmony with what is said in charter?

@RayStick RayStick marked this pull request as draft February 10, 2026 10:43
@RayStick RayStick changed the title Finalise Finalise governance docs - resolve outstanding queries Feb 10, 2026
@RayStick RayStick self-assigned this Feb 10, 2026
@RayStick RayStick marked this pull request as ready for review February 11, 2026 15:09
@RayStick RayStick requested review from CesarCaballeroGaudes, goodalse2019, m-miedema and smoia and removed request for m-miedema February 11, 2026 15:12
@RayStick RayStick moved this to In Progress in Physiopy SC Feb 12, 2026
@RayStick RayStick moved this to PR needs review in Physiopy Feb 18, 2026
@RayStick RayStick mentioned this pull request Mar 4, 2026
4 tasks
Comment thread org-docs/CHARTER.md Outdated

@m-miedema m-miedema 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.

This looks good! The definition of active involvement in a project is especially helpful to have and I think the one you came up with is fair (although can maybe be clarified about whether meeting attendance and evidence of contributions are both necessary).

For the code of conduct, they seem in harmony with each other and as far as I can tell what we've written in the charter. However, we do need to decide on which reporting pathways to include. My suggestion is to report via the gmail or to any member of the steering committee. We could also consider whether the person reporting has any agency following reporting. For example, this person may wish to make a disclosure or express concern without necessarily triggering an enforcement response. I'd recommend exploring this in another issue/PR in the future.

Comment thread org-docs/CHARTER.md Outdated
Comment thread org-docs/CHARTER.md Outdated
@RayStick RayStick mentioned this pull request Mar 4, 2026
7 tasks
Comment thread org-docs/CHARTER.md Outdated
RayStick and others added 3 commits June 3, 2026 13:44
Group discussion in SC meeting

Co-authored-by: Stefano Moia <s.moia.research@gmail.com>
Discussed at the SC meeting June 3rd

Co-authored-by: Stefano Moia <s.moia.research@gmail.com>
Co-authored-by: Stefano Moia <s.moia.research@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: PR needs review
Status: In Progress

Development

Successfully merging this pull request may close these issues.

Finalise revised aim statement Finalise governance docs

3 participants