This is an automated email from the ASF dual-hosted git repository.
dsmiley pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/solr.git
The following commit(s) were added to refs/heads/main by this push:
new d79de34b590 SOLR-18286: dev-docs/changelog.adoc: document "type"
(#4530)
d79de34b590 is described below
commit d79de34b590ec02ff549cc2d3bbe9bfe50279379
Author: Abhishek Umarjikar <[email protected]>
AuthorDate: Sat Jun 20 22:08:29 2026 +0530
SOLR-18286: dev-docs/changelog.adoc: document "type" (#4530)
Repeat changelog "type" documentation/usage.
---
dev-docs/changelog.adoc | 35 +++++++++++++++++++++++++++++++++++
1 file changed, 35 insertions(+)
diff --git a/dev-docs/changelog.adoc b/dev-docs/changelog.adoc
index 22b18b19635..bd80fec4292 100644
--- a/dev-docs/changelog.adoc
+++ b/dev-docs/changelog.adoc
@@ -53,6 +53,41 @@ links:
url: https://issues.apache.org/jira/browse/SOLR-3333
----
+=== Changelog Types Reference
+
+[cols="1,2,3",options="header"]
+|===
+| Type | Description | When to Use (Examples)
+
+| `added`
+| For changes requiring a user to take action to use (opt-in).
+| Could be completely new features or simply new configuration values on
existing features. Typically documented in the Ref Guide.
+
+| `changed`
+| For improvements; not opt-in.
+| Modifying behavior or performance of existing requests/configuration.
+
+| `fixed`
+| For improvements that are deemed to have fixed buggy behavior.
+| Fixing a `NullPointerException`, correcting data corruption issues, or
resolving UI glitches.
+
+| `deprecated`
+| For marking things deprecated.
+| Declaring a configuration option, class, or API endpoint as deprecated ahead
of a future removal.
+
+| `removed`
+| For code removed.
+| Removing a previously deprecated parameter, class, or legacy module.
+
+| `dependency_update`
+| For updates to dependencies.
+| Bumping third-party library versions (e.g., Lucene, Jetty, Jackson).
+
+| `other`
+| For anything else. Most such changes are too small/minor to bother with a
changelog entry.
+| Large/significant refactorings, build changes, test infrastructure, or
documentation.
+|===
+
=== 3.1 Tool to draft a YAML for your change
We have a gradle task that bootstraps a YAML file in the
`changelog/unreleased/` directory. The task will use your current branch name
as a file name and also title, and will
