| name | webrtc-changelog |
| description | Generate a professional HTML changelog from WebRTC git logs. Automatically categorizes changes, includes a high-level summary, and provides detailed commit and review links. |
WebRTC Changelog Generator
webrtc-changelog automates the generation of a professional, categorized HTML
report for WebRTC changes.
Workflow
- Fetch Branch Information: Navigate to
https://chromiumdash.appspot.com/branches and extract the current and
previous branch numbers associated with the milestone from the webrtc
column of the first two rows in the Branch details table. These will be
used as <branch2> (current) and <branch1> (previous). Note the milestone
number (e.g., 148).
- Update Git Execute
git fetch origin to retrieve the remote git
branches.
- Fetch Git Log: Execute
git log branch-heads/<branch1>..branch-heads/<branch2> to retrieve the
commit history.
- Generate Summary: Analyze the retrieved git log and produce a high-level
summary of the most significant changes. The summary MUST be formatted as an
HTML unordered list (
<ul><li>...</li></ul>) for best presentation in the
report.
- Generate HTML Report: Use the
generate_changelog.py script to create
the final report, injecting the generated HTML summary and the milestone:
python3 tools_webrtc/generate_changelog.py <branch1> <branch2> <output_file> --summary_text "<summary_html>" --milestone M<milestone_number>
Features
AI-Powered Summary
- High-level, one-pager overview of the release.
- Automatically includes commit and author statistics.
Categorized Changes
- Automatically categorizes commits based on keywords in the commit.
- Provides 📝 (Commit) and 🔍 (Review/Gerrit) links for each entry.
- Automatically converts
Bug: references (e.g., webrtc:123, chromium:456,
b/789) into hyperlinks.
