From c4329431b5d6d9033e9cb995cf4f133300fb3d81 Mon Sep 17 00:00:00 2001
From: Mathis Maquenne <124215603+mathismqn@users.noreply.github.com>
Date: Mon, 18 Aug 2025 11:20:29 +0200
Subject: [PATCH] docs: update for v1.2.0

---
 CHANGELOG.md | 16 ++++++++++++++++
 README.md    | 18 +++++++++---------
 2 files changed, 25 insertions(+), 9 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 43badf4..62679bc 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,22 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.0] - 2025-08-18
+
+### Added
+- New `artist` command to download an artist’s top tracks.
+- `--limit` flag for the `artist` command to restrict the number of tracks.
+- `--strict` flag for downloads: fail if the requested quality is unavailable.
+
+### Changed
+- Default download quality is now **MP3 320kbps**.
+
+### Removed
+- The `--quality=best` option. Fallback to lower quality is now the **default behavior**; use the new `--strict` flag if you want to prevent fallback.
+
+### Fixed
+- Handle error when `SNG_CONTRIBUTORS` metadata is empty.
+
 ## [1.1.1] - 2025-06-16
 
 ### Fixed
diff --git a/README.md b/README.md
index 7de38c5..8a38617 100644
--- a/README.md
+++ b/README.md
@@ -19,8 +19,8 @@ A simple Go tool for downloading music from [Deezer](https://www.deezer.com).
 
 ## Features
 
-* Download playlists and albums from Deezer
-* Select audio quality: MP3 128kbps, MP3 320kbps, or FLAC (⚠️ non-premium accounts are limited to 128kbps)
+* Download playlists, albums, and artists' top tracks from Deezer
+* Select audio quality: MP3 128kbps, MP3 320kbps (default), or FLAC (⚠️ non-premium accounts are limited to 128kbps)
 * Automatically adds metadata tags to downloaded files
 * Fetch and tag songs with BPM and musical key
 * Smart skip system: avoids re-downloading already existing files using hashes and metadata
@@ -38,7 +38,7 @@ To install **GoDeez**, simply download the latest binary for your platform from
 Example (Linux/macOS):
 ```bash
 # Move the downloaded binary to /usr/local/bin for easy access from anywhere
-mv godeez-1.1.0-linux-amd64 /usr/local/bin/godeez
+mv godeez-1.2.0-linux-amd64 /usr/local/bin/godeez
 ```
 
 ## Configuration
@@ -119,18 +119,18 @@ Usage:
   godeez download [command]
 
 Available Commands:
-  album       Download songs from album
-  playlist    Download songs from playlist
+  album       Download songs from an album
+  artist      Download top songs from an artist
+  playlist    Download songs from a playlist
 
 Flags:
       --bpm                fetch BPM/key and add to file tags
+      --config string      config file (default ~/.godeez/config.toml)
   -h, --help               help for download
-  -q, --quality string     download quality [mp3_128, mp3_320, flac, best] (default "best")
+  -q, --quality string     download quality [mp3_128, mp3_320, flac] (default "mp3_320")
+      --strict             fail the song download if the quality is not available
   -t, --timeout duration   timeout for each download (e.g. 10s, 1m, 2m30s) (default 2m0s)
 
-Global Flags:
-      --config string   config file (default ~/.godeez/config.toml)
-
 Use "godeez download [command] --help" for more information about a command.
 ```