Improve release notes template with detailed installation methods
Updated template to hybrid format combining best of v4.27.0 and v4.25.0: Benefits from detailed format (v4.25.0): - 4 complete installation methods (Quick/Docker/Binary/Helm) - Copy-pasteable commands for each method - Explicit Downloads section listing what's available - Better for new users and SEO Benefits from simple format (v4.27.0): - Consistent section ordering - Clean, scannable structure - Breaking Changes section always present Changes descriptions now require context and user impact, not just one-liners. This helps users understand if a change affects them without clicking through to issues. Based on Codex analysis that detailed format serves more user types better: new users, quick upgrades, search indexing, and professional appearance.
This commit is contained in:
parent
19620faa30
commit
c46b52be89
1 changed files with 47 additions and 18 deletions
|
|
@ -54,48 +54,77 @@ This document defines what must be true for a successful Pulse release. You (AI)
|
||||||
|
|
||||||
### 6. Release Notes Prepared
|
### 6. Release Notes Prepared
|
||||||
**Must be true:**
|
**Must be true:**
|
||||||
- Release notes follow standard template format
|
- Release notes follow standard template format (see below)
|
||||||
- Sections included: New Features, Bug Fixes, Improvements, Breaking Changes
|
- Sections included in order: New Features, Bug Fixes, Improvements, Breaking Changes
|
||||||
- Each item references issue numbers where applicable (#123)
|
- Each change is descriptive with context, not just "fix X" (explain impact)
|
||||||
|
- Issue numbers referenced where applicable (#123)
|
||||||
- No emoji in headers
|
- No emoji in headers
|
||||||
- Installation section includes Docker and Manual install instructions
|
- Installation section includes all 4 methods: Quick Install, Docker, Manual Binary, Helm
|
||||||
|
- Each installation method has complete, copy-pasteable commands
|
||||||
|
- Downloads section lists what's available
|
||||||
- Breaking Changes section present (say "None" if no breaking changes)
|
- Breaking Changes section present (say "None" if no breaking changes)
|
||||||
- For RC releases: Include backup warning at the top
|
- Notes section has key highlights or migration guidance
|
||||||
|
- For RC releases: Include backup warning at the top of release notes
|
||||||
|
|
||||||
**Template structure:**
|
**Template structure:**
|
||||||
```markdown
|
```markdown
|
||||||
## What's Changed
|
## What's Changed
|
||||||
|
|
||||||
### New Features
|
### New Features
|
||||||
- Description (#issue)
|
- Brief but descriptive change with context (#issue)
|
||||||
|
|
||||||
### Bug Fixes
|
### Bug Fixes
|
||||||
- Description (#issue)
|
- What was broken and how it's fixed (#issue)
|
||||||
|
|
||||||
### Improvements
|
### Improvements
|
||||||
- Description (#issue)
|
- Enhancement with user impact described (#issue)
|
||||||
|
|
||||||
### Breaking Changes
|
### Breaking Changes
|
||||||
None
|
None
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
### Docker
|
**Quick Install (systemd / LXC / Proxmox VE):**
|
||||||
```bash
|
```bash
|
||||||
docker pull rcourtman/pulse:vX.X.X
|
curl -fsSL https://raw.githubusercontent.com/rcourtman/Pulse/main/install.sh | bash
|
||||||
```
|
```
|
||||||
|
|
||||||
### Manual Install
|
**Docker:**
|
||||||
Download the universal package that auto-detects your architecture:
|
```bash
|
||||||
- `pulse-vX.X.X.tar.gz`
|
docker pull rcourtman/pulse:vX.X.X
|
||||||
|
docker stop pulse && docker rm pulse
|
||||||
|
docker run -d --name pulse \
|
||||||
|
--restart unless-stopped \
|
||||||
|
-p 7655:7655 -p 7656:7656 \
|
||||||
|
-v /opt/pulse/data:/data \
|
||||||
|
rcourtman/pulse:vX.X.X
|
||||||
|
```
|
||||||
|
|
||||||
Or choose architecture-specific:
|
**Manual Binary (amd64 example):**
|
||||||
- `pulse-vX.X.X-linux-amd64.tar.gz` - Intel/AMD 64-bit
|
```bash
|
||||||
- `pulse-vX.X.X-linux-arm64.tar.gz` - ARM 64-bit
|
curl -LO https://github.com/rcourtman/Pulse/releases/download/vX.X.X/pulse-vX.X.X-linux-amd64.tar.gz
|
||||||
- `pulse-vX.X.X-linux-armv7.tar.gz` - ARM 32-bit
|
sudo systemctl stop pulse
|
||||||
|
sudo tar -xzf pulse-vX.X.X-linux-amd64.tar.gz -C /usr/local/bin pulse
|
||||||
|
sudo systemctl start pulse
|
||||||
|
```
|
||||||
|
|
||||||
|
**Helm:**
|
||||||
|
```bash
|
||||||
|
helm upgrade --install pulse oci://ghcr.io/rcourtman/pulse-chart \
|
||||||
|
--version X.X.X \
|
||||||
|
--namespace pulse \
|
||||||
|
--create-namespace
|
||||||
|
```
|
||||||
|
|
||||||
|
## Downloads
|
||||||
|
- Universal tarball (auto-detects architecture): `pulse-vX.X.X.tar.gz`
|
||||||
|
- Architecture-specific: `amd64`, `arm64`, `armv7`
|
||||||
|
- Host agent packages: macOS, Windows, Linux
|
||||||
|
- Helm chart: `pulse-X.X.X.tgz`
|
||||||
|
- SHA256 checksums: `checksums.txt`
|
||||||
|
|
||||||
## Notes
|
## Notes
|
||||||
- Important notes or migration instructions
|
- Key highlights, important warnings, or migration instructions
|
||||||
```
|
```
|
||||||
|
|
||||||
### 7. Docker Images Published
|
### 7. Docker Images Published
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue