Skip to content

chore: Update contributing guidelines#10770

Open
bilgeyucel wants to merge 2 commits intomainfrom
contributing-guidelines
Open

chore: Update contributing guidelines#10770
bilgeyucel wants to merge 2 commits intomainfrom
contributing-guidelines

Conversation

@bilgeyucel
Copy link
Contributor

Proposed Changes:

  • Add a TLDR for first PR
  • Fix the broken link
  • Some grammar fixes
  • Add high quality contributions section
  • Add info about using AI assistants
  • Add info about issues to be handled internally

Checklist

  • I have read the contributors guidelines and the code of conduct.
  • I have updated the related issue with new insights and changes.
  • I have added unit tests and updated the docstrings.
  • I've used one of the conventional commit types for my PR title: fix:, feat:, build:, chore:, ci:, docs:, style:, refactor:, perf:, test: and added ! in case the PR includes breaking changes.
  • I have documented my code.
  • I have added a release note file, following the contributors guidelines.
  • I have run pre-commit hooks and fixed any issue.

* Add a TLDR for first PR
* Fix the broken link
* Some grammer fixes
* Add high quality contributions section
* Add info about using AI assistants
* Add info about issues to be handled internally
@bilgeyucel bilgeyucel self-assigned this Mar 8, 2026
@bilgeyucel bilgeyucel requested review from a team as code owners March 8, 2026 21:06
@bilgeyucel bilgeyucel requested review from bogdankostic and removed request for a team March 8, 2026 21:06
@bilgeyucel bilgeyucel added the ignore-for-release-notes PRs with this flag won't be included in the release notes. label Mar 8, 2026
@vercel
Copy link

vercel bot commented Mar 8, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
haystack-docs Ready Ready Preview, Comment Mar 8, 2026 9:09pm

Request Review

Copy link
Contributor

@bogdankostic bogdankostic left a comment

Choose a reason for hiding this comment

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

Nice! I especially like the high-level to-do list. Just left a few language-related comments.


If you then still feel the need to ask a question and need clarification, you can use one of our
[Community Channels](https://haystack.deepset.ai/community), Discord, in particular, is often very helpful.
If you then still feel the need to ask a question and need clarification, you can use [Haystack Discord Server](https://discord.com/invite/xYvH6drSmA)
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
If you then still feel the need to ask a question and need clarification, you can use [Haystack Discord Server](https://discord.com/invite/xYvH6drSmA)
If you then still feel the need to ask a question and need clarification, you can use [Haystack's Discord Server](https://discord.com/invite/xYvH6drSmA).

- **Documentation** — If your change adds or alters user-facing behavior, add a new docs page or update the relevant one in `docs-website/` (edit under `docs/` for the next release; add new pages to `sidebars.js`). See the [Documentation Contributing Guide](docs-website/CONTRIBUTING.md) for where to edit, frontmatter, and navigation.
- **Release notes** — Add a release note under `releasenotes/notes` with `hatch run release-note your-change-name` (see [Release notes](#release-notes)); maintainers can add `ignore-for-release-notes` for tests-only or CI-only changes.
- **Open the PR** — Use a [conventional commit](https://www.conventionalcommits.org/en/v1.0.0/) title, fill the [PR template](.github/pull_request_template.md), and if the PR was fully AI-generated, add a [short disclaimer](#using-ai-assistants-to-contribute). Enable "Allow edits and access to secrets by maintainers" on the PR.
- **Before submitting** — Fix any [CI](#ci-continuous-integration) failures and address review feedback.
Copy link
Contributor

Choose a reason for hiding this comment

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

Technically the PR is already submitted, so I'd propose the following wording:

Suggested change
- **Before submitting** — Fix any [CI](#ci-continuous-integration) failures and address review feedback.
- **Once the PR is open** — Fix any [CI](#ci-continuous-integration) failures and address review feedback.

Comment on lines +115 to +116
- If the team is able to reproduce the issue, the issue will be scheduled for a fix or left to be
[implemented by someone](https://github.com/deepset-ai/haystack/issues?q=is%3Aissue%20state%3Aopen%20label%3A"Contributions%20wanted!").
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
- If the team is able to reproduce the issue, the issue will be scheduled for a fix or left to be
[implemented by someone](https://github.com/deepset-ai/haystack/issues?q=is%3Aissue%20state%3Aopen%20label%3A"Contributions%20wanted!").
- If the team is able to reproduce it, the issue will be scheduled for a fix or left to be
[picked up by a community contributor](https://github.com/deepset-ai/haystack/issues?q=is%3Aissue%20state%3Aopen%20label%3A"Contributions%20wanted!").

@@ -116,7 +126,7 @@ find related suggestions.
- Make sure that you are using the latest version.
- Read the [documentation](https://docs.haystack.deepset.ai/docs/intro) carefully and find out if the functionality
is already covered, maybe by an individual configuration.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
is already covered, maybe by an individual configuration.
is already covered, possibly via particular configuration parameters.

> [!IMPORTANT]
> When contributing to this project, you must agree that you have authored 100% of the content, that you have the
> necessary rights to the content and that the content you contribute may be provided under the project license.
> When contributing to this project, you must agree that you have authored 100% of the content, that you have the necessary rights to the content and that the content you contribute may be provided under the project license.
Copy link
Contributor

Choose a reason for hiding this comment

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

Given that further below we allow the usage of AI assistants, maybe we should rephrase this to something along the following: you have authored or carefully reviewed 100% of the content

limited in scope, easily fixable and low priority, so there is absolutely no reason why you should not try fixing them,
it's a good excuse to start looking into the project and a safe space for experimenting failure: if you don't get the
limited in scope, easily fixable and low priority, so there is absolutely no reason why you should not try fixing them.
It's a good excuse to start looking into the project and a safe space for experimenting failure: if you don't get the
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
It's a good excuse to start looking into the project and a safe space for experimenting failure: if you don't get the
It's a good excuse to start looking into the project and a safe space to experiment and fail: if you don't get the

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ignore-for-release-notes PRs with this flag won't be included in the release notes. topic:DX Developer Experience

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants