CLOUDP-295785 - remove title from changelog file generator (#451)

# Summary

Based on discussions we had
[here](https://mongodb.slack.com/archives/CGLP6R2PQ/p1757923176704559?thread_ts=1757920788.967209&cid=CGLP6R2PQ)
we have decided to drop `title` from changelog files frontmatter. This
gives false assumption that it will be included in the final Release
Notes, which is not the case. Additionally `title` didn't have any
meaningful usage. Now it will be added as initial contents of the file
and dropped from frontmatter.

## Proof of Work

Creating a changelog after updating:
```
(venv) ➜  mongodb-kubernetes git:(maciejk/ar-changelog-remove-title) python3 -m scripts.release.create_changelog -k feature "Test something that is very long title about some feature" -e
Created changelog entry at: /Users/maciej.karas/mongodb/mongodb-kubernetes/changelog/20250915_feature_test_something_that_is_very_long_title_about_some.md

(venv) ➜  mongodb-kubernetes git:(maciejk/ar-changelog-remove-title) ✗ cat changelog/20250915_feature_test_something_that_is_very_long_title_about_some.md
---
kind: feature
date: 2025-09-15
---

* Test something that is very long title about some feature

(venv) ➜  mongodb-kubernetes git:(maciejk/ar-changelog-remove-title) python3 -m scripts.release.release_notes --initial-version 1.2.0
# MCK 1.4.0 Release Notes

## New Features

* Some feature that is properly described with full context
```

## Checklist

- [x] Have you linked a jira ticket and/or is the ticket in the title?
- [x] Have you checked whether your jira ticket required DOCSP changes?
- [x] Have you added changelog file?
    - use `skip-changelog` label if not needed
- refer to [Changelog files and Release
Notes](https://github.com/mongodb/mongodb-kubernetes/blob/master/CONTRIBUTING.md#changelog-files-and-release-notes)
section in CONTRIBUTING.md for more details

Author: MaciejKaras

CONTRIBUTING.md

@@ -18,7 +18,7 @@ Each Pull Request usually has a changelog file that describes the changes made i
 Changelog files are placed in the `changelog/` directory and used to generate the Release Notes for the
 upcoming release. Preview of the Release Notes is automatically added as comment to each Pull Request.
 The changelog file needs to follow the naming convention
-`YYYYMMDD-<change_kind>-<short-description>.md`. To create changelog file please use the
+`YYYYMMDD-<change_kind>-<short-title>.md`. To create changelog file please use the
 `scripts/release/create_changelog.py` script. Example usage:
 
 ```console
@@ -34,7 +34,7 @@ usage: create_changelog.py [-h] [-c ] [-d ] [-e] -k  title
 Utility to easily create a new changelog entry file.
 
 positional arguments:
-  title                 Title for the changelog entry
+  title                 Title used in changelog filename and passed as initial file contents
 
 options:
   -h, --help            show this help message and exit

scripts/release/changelog.py

@@ -35,10 +35,9 @@ def from_str(kind_str: str) -> "ChangeKind":
 
 
 class ChangeEntry:
-    def __init__(self, date: datetime, kind: ChangeKind, title: str, contents: str):
+    def __init__(self, date: datetime, kind: ChangeKind, contents: str):
         self.date = date
         self.kind = kind
-        self.title = title
         self.contents = contents
 
 
@@ -129,7 +128,7 @@ def extract_changelog_entry_from_contents(file_contents: str) -> ChangeEntry:
     ## Add newline to contents so the Markdown file also contains a newline at the end
     contents = data.content + "\n"
 
-    return ChangeEntry(date=date, title=str(data["title"]), kind=kind, contents=contents)
+    return ChangeEntry(date=date, kind=kind, contents=contents)
 
 
 def get_changelog_filename(title: str, kind: ChangeKind, date: datetime) -> str:

scripts/release/create_changelog.py

@@ -53,7 +53,7 @@
   - '{str(ChangeKind.FIX)}' for bugfix entries
   - '{str(ChangeKind.OTHER)}' for other entries""",
     )
-    parser.add_argument("title", type=str, help="Title for the changelog entry")
+    parser.add_argument("title", type=str, help="Title used in changelog filename and passed as initial file contents")
     args = parser.parse_args()
 
     title = args.title
@@ -72,10 +72,10 @@
     with open(changelog_path, "w") as f:
         # Add frontmatter based on args
         f.write("---\n")
-        f.write(f"title: {title}\n")
         f.write(f"kind: {str(kind)}\n")
         f.write(f"date: {date_str}\n")
         f.write("---\n\n")
+        f.write(f"* {title}\n")
 
     if args.editor:
         editor = os.environ.get("EDITOR", "vi")  # Fallback to vim if EDITOR is not set

scripts/release/tests/changelog_test.py

@@ -69,7 +69,6 @@ def test_strip_changelog_entry_frontmatter():
 
     change_entry = extract_changelog_entry_from_contents(file_contents)
 
-    assert change_entry.title == "This is my change"
     assert change_entry.kind == ChangeKind.FEATURE
     assert change_entry.date == datetime.date(2025, 7, 10)
     assert (