Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

osrd stage 2 #141

Open
wants to merge 5 commits into
base: main
Choose a base branch
from
Open

osrd stage 2 #141

wants to merge 5 commits into from

Conversation

flomonster
Copy link
Contributor

@flomonster flomonster commented Sep 16, 2024

Feedback:

  • I don't know if editing the project_proposals/osrd.md file is the right thing to do for this request.
  • The first three criteria are very similar. At least the only thing to fill in as a project is the link to the repository pulses.
  • Not sure it was the best way to proof the usage of REUSE and DCO
  • There are no criteria for the openness of communication channels with contributors. The fact that OSRD has a matrix server accessible to all makes it easier to integrate contributors from outside SNCF.
  • Requiring projects to have dependencies security alerts and secret scanning alerts seems reasonable for stage 2 (it's a small proof of maturity).

@cornelius
Copy link
Member

From yesterday's TC meeting:

  • I don't know if editing the project_proposals/osrd.md file is the right thing to do for this request.

We will provide a separate questionnaire, so that the stages are separated and there is no confusion about what to add when and where.

  • The first three criteria are very similar. At least the only thing to fill in as a project is the link to the repository pulses.

We will keep this relatively free-form. Adding an explanation and links to metrics such as the repo pulse is probably good
enough as a base for the evaluation for now.

  • Not sure it was the best way to proof the usage of REUSE and DCO

We will add more details in the questionnaire (which is still to be created as a separate file).

  • There are no criteria for the openness of communication channels with contributors. The fact that OSRD has a matrix server accessible to all makes it easier to integrate contributors from outside SNCF.

To be documented in more detail.

  • Requiring projects to have dependencies security alerts and secret scanning alerts seems reasonable for stage 2 (it's a small proof of maturity).

Good point, should be added.


> [!NOTE]
> All this information is taken from [here](https://github.com/OpenRailAssociation/osrd/pulse)

Copy link
Member

Choose a reason for hiding this comment

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

Another interesting metric in this context would be the Contributor Absence Factor, i.e. how big is the dependence on individual people in the project.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I was unable to retrieve this stat. The tools that can provide it are a bit complicated to set up.

## Open to external contributors

* Have a clear release process which communicates to users what to expect from releases. This includes a clear versioning scheme and cryptographically signing release artifacts.
* Describe on our website here: https://osrd.fr/en/docs/guides/release/
Copy link
Member

Choose a reason for hiding this comment

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

In addition to how the releases work from a technical point of view, it would be helpful to have information how users are affected by releases and how they can plan with releases. This would include things like the release cycle, stability of releases, if and how beta and other preview releases are available, and how this is communicated (e.g. is there a versioning scheme indicating stability of releases).

Related to this is information how users can provide feedback for releases, e.g. by opening issues, or how they can follow or even influence the roadmap, so that they can plan regarding future releases.

* Specifications must have at least one public reference implementation.
* Describe on our website here: https://osrd.fr/en/docs/reference/
* Project has implemented an open governance process. It's documented how decisions are taken in the project and how people can become committers and maintainers.
* https://github.com/OpenRailAssociation/osrd/blob/dev/GOVERNANCE.md
Copy link
Member

Choose a reason for hiding this comment

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

I think we have to make clearer what exactly we mean with open governance, or is this already clear enough? Would maybe something like a checklist help what to look at regarding assessing the openness of the governance?

Signed-off-by: Florian Amsallem <[email protected]>
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.

3 participants