Add governance document for the DANDI Archive Project#204
Conversation
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
satra
left a comment
There was a problem hiding this comment.
some suggestions for the doc. mostly to create separation between policy and implementation.
| - 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 |
There was a problem hiding this comment.
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.
There was a problem hiding this comment.
could have a reference to sociocracy.
Thanks. I have update the Core Principles section with this statement.
There was a problem hiding this comment.
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?
| ### 8.1 Versioning | ||
| - [Semantic Versioning 2.0](https://semver.org/spec/v2.0.0.html) for APIs and libraries. | ||
|
|
||
| ### 8.2 Release Steps |
There was a problem hiding this comment.
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.
There was a problem hiding this comment.
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.
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>
waxlamp
left a comment
There was a problem hiding this comment.
This looks good ovverall (especially as a starting point, if we wish to flesh things out later). Some comments/questions:
- 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.
- 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.
- 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.)
Co-authored-by: Satrajit Ghosh <satrajit.ghosh@gmail.com>
✅ Deploy Preview for dandi-docs ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
…into governance-doc
Co-authored-by: Roni Choudhury <aichoudh@gmail.com>
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. |
Effective DateStatus