You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@datafusion.apache.org by ag...@apache.org on 2024/10/16 22:15:31 UTC
(datafusion) branch main updated: docs: Add documentation about conventional commits (#12971)
This is an automated email from the ASF dual-hosted git repository.
agrove pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/datafusion.git
The following commit(s) were added to refs/heads/main by this push:
new d8e4e92daf docs: Add documentation about conventional commits (#12971)
d8e4e92daf is described below
commit d8e4e92daf7f20eef9af6919a8061192f7505043
Author: Andy Grove <ag...@apache.org>
AuthorDate: Wed Oct 16 16:15:27 2024 -0600
docs: Add documentation about conventional commits (#12971)
* add documentation about conventional commits
* prettier
---
docs/source/contributor-guide/index.md | 14 ++++++++++++++
1 file changed, 14 insertions(+)
diff --git a/docs/source/contributor-guide/index.md b/docs/source/contributor-guide/index.md
index 79a9298798..4645fe5c88 100644
--- a/docs/source/contributor-guide/index.md
+++ b/docs/source/contributor-guide/index.md
@@ -116,6 +116,20 @@ If you are concerned that a larger design will be lost in a string of small PRs,
Note all commits in a PR are squashed when merged to the `main` branch so there is one commit per PR after merge.
+## Conventional Commits & Labeling PRs
+
+We generate change logs for each release using an automated process that will categorize PRs based on the title
+and/or the GitHub labels attached to the PR.
+
+We follow the [Conventional Commits] specification to categorize PRs based on the title. This most often simply means
+looking for titles starting with prefixes such as `fix:`, `feat:`, `docs:`, or `chore:`. We do not enforce this
+convention but encourage its use if you want your PR to feature in the correct section of the changelog.
+
+The change log generator will also look at GitHub labels such as `bug`, `enhancement`, or `api change`, and labels
+do take priority over the conventional commit approach, allowing maintainers to re-categorize PRs after they have been merged.
+
+[conventional commits]: https://www.conventionalcommits.org/en/v1.0.0/
+
# Reviewing Pull Requests
Some helpful links:
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@datafusion.apache.org
For additional commands, e-mail: commits-help@datafusion.apache.org