Skip to content

CONTRIBUTING: add some initial guidelines #6485

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

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

last-genius
Copy link
Contributor

Some rough guidelines on the contribution process for the project. Intended more as a starting point for a discussion.

@last-genius
Copy link
Contributor Author

MustardseedX

This comment was marked as spam.

@lindig
Copy link
Contributor

lindig commented May 27, 2025

I believe we should manage expectations by saying that commits that break existing (non-public) tests are likely to be reverted. This may sound unfair because tests are not public but I can't see how we can avoid that. The test infrastructure we have in place is almost impossible to make public, independent of any licensing issues.

@psafont
Copy link
Member

psafont commented May 27, 2025

The test infrastructure we have in place is almost impossible to make public, independent of any licensing issues.

What could be made public is the operations / features that are considered essential, and are never to be broken. With this, the existing public tests can be enhanced (unit tests or end-to-end xcp-ng ones) to a point where all the tests that are considered for reverting are public, even if it's replicated inside xenserver's testing suite.

@lindig
Copy link
Contributor

lindig commented May 27, 2025

We might have public tests not in place immediately; I am in favour to add some words about reverting commits and merge this.

@last-genius last-genius force-pushed the asv/contribution-guide branch from 5710c8d to 20070e4 Compare May 27, 2025 15:00
@last-genius
Copy link
Contributor Author

Added a quick note:

If a commit has been determined to break integration testing at a later stage,
please note that the first and safest measure will almost always be reverting
the faulty commit. Making sure critical tests are passing remains a priority
over waiting for some commit to be reworked or refactored (which can be worked
on after a revert has been done). Though we are striving to make more tests
public (with failure then being visible to all), as long as some critical tests
remain private, this will also apply to such tests (with maintainers flagging
the breakage preferrably describing at least the gist of the test).

@psafont
Copy link
Member

psafont commented May 27, 2025

I can't think of anything in particular that the document is missing. I'd like Rob to review it, however

@last-genius last-genius force-pushed the asv/contribution-guide branch from 20070e4 to 5d8cf6f Compare May 28, 2025 07:03
@last-genius last-genius force-pushed the asv/contribution-guide branch from 5d8cf6f to 1c581c0 Compare May 28, 2025 07:03
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.

8 participants