Skip to content

Add governance document for the DANDI Archive Project#204

Open
kabilar wants to merge 74 commits into
dandi:masterfrom
kabilar:governance-doc
Open

Add governance document for the DANDI Archive Project#204
kabilar wants to merge 74 commits into
dandi:masterfrom
kabilar:governance-doc

Conversation

@kabilar
Copy link
Copy Markdown
Member

@kabilar kabilar commented Aug 11, 2025

@kabilar kabilar self-assigned this Aug 11, 2025
@kabilar kabilar changed the title [WIP] Add governance document Add DANDI governance document Sep 9, 2025
@kabilar kabilar marked this pull request as ready for review September 9, 2025 16:55
Comment thread docs/terms-policies/governance.md
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Copy link
Copy Markdown
Member

@satra satra left a comment

Choose a reason for hiding this comment

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

some suggestions for the doc. mostly to create separation between policy and implementation.

Comment thread docs/terms-policies/governance.md
Comment thread docs/terms-policies/governance.md Outdated
Comment thread docs/terms-policies/governance.md Outdated
- Project Leadership provides guidance on prioritization of targets.
- Public notes of these meetings are available on [Google Drive](https://drive.google.com/drive/folders/1-jXLpcrh3L650FiZyTFgcs096nZjO2C3).

### 6.2 Consensus Process
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.

could have a reference to sociocracy. one consideration is whether relevant voices have been heard. i.e. should the change be announced somewhere on a project roadmap or board.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

could have a reference to sociocracy.

Thanks. I have update the Core Principles section with this statement.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

one consideration is whether relevant voices have been heard. i.e. should the change be announced somewhere on a project roadmap or board.

We welcome input from the broader community. Currently, changes are announced through pull requests and the subsequent release notes. Using GitHub project boards and Google Docs/Sheets project roadmaps haven't worked for our team in the past. So we currently use our Google Docs meeting minutes that are public to also track developments. Is there a different tool or process that you would like us to try out?

Comment thread docs/terms-policies/governance.md Outdated
### 8.1 Versioning
- [Semantic Versioning 2.0](https://semver.org/spec/v2.0.0.html) for APIs and libraries.

### 8.2 Release Steps
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 seems more implementation than policy. perhaps that's a consideration in going through this document to separate policy from example implementation. the implementation could be an example of some policy on how we will do it in dandi.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Thanks. I tend to lean towards implementation specifics when writing. Could you share an example or two of how you'd phrase these as policy statements? That would help me apply a consistent approach across the document.

Comment thread docs/terms-policies/governance.md
kabilar and others added 4 commits December 1, 2025 16:25
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Copy link
Copy Markdown
Member

@waxlamp waxlamp left a comment

Choose a reason for hiding this comment

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

This looks good ovverall (especially as a starting point, if we wish to flesh things out later). Some comments/questions:

  1. The text starting in Section 6 or so becomes quite terse, with sentence fragments in bullet points expressing the general ideas associated with those concepts. I think these can use some more detail and precision.
  2. As I mentioned in one of the comments below, a lot of the role/responsibility/process groupings of bullet points seem like summaries or examples of that entity, rather than an exhaustive definition. This is fine, but we should be more explicit about that if that's the intent.
  3. What is the overall purpose of this document? If it's to bind behavior and process, then I don't think it has enough detail. If it's to transmit an overall idea of how the project runs, then I think it's useful. (I don't have enough experience with governance documents, or governance in general, to understand this fully.)

Comment thread docs/terms-policies/governance.md Outdated
Comment thread docs/terms-policies/governance.md Outdated
Comment thread docs/terms-policies/governance.md Outdated
Comment thread docs/terms-policies/governance.md Outdated
Comment thread docs/terms-policies/governance.md Outdated
Comment thread docs/terms-policies/governance.md Outdated
kabilar and others added 2 commits February 9, 2026 14:33
@netlify
Copy link
Copy Markdown

netlify Bot commented Apr 5, 2026

Deploy Preview for dandi-docs ready!

Name Link
🔨 Latest commit fc1200f
🔍 Latest deploy log https://app.netlify.com/projects/dandi-docs/deploys/6a0b86ff617e7900081f1e62
😎 Deploy Preview https://deploy-preview-204--dandi-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@kabilar
Copy link
Copy Markdown
Member Author

kabilar commented May 18, 2026

What is the overall purpose of this document? If it's to bind behavior and process, then I don't think it has enough detail. If it's to transmit an overall idea of how the project runs, then I think it's useful. (I don't have enough experience with governance documents, or governance in general, to understand this fully.)

Hi @waxlamp, I think under ideal scenarios it is the former, but it will likely end up being somewhere in between the former and the latter. Happy to apply further suggestions, thanks.

@kabilar kabilar changed the title Add DANDI governance document Add DANDI governance document for the DANDI Archive Project May 18, 2026
@kabilar kabilar requested review from satra, waxlamp and yarikoptic May 18, 2026 21:50
@kabilar kabilar changed the title Add DANDI governance document for the DANDI Archive Project Add governance document for the DANDI Archive Project May 18, 2026
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.

7 participants