diff --git a/CHANGELOG.md b/CHANGELOG.md
index 1d1a5991a5..82d0d72cba 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,19 +1,25 @@
 # Roo Code Changelog
 
-## 3.17.0
+## [3.17.0] - 2025-05-14
 
-### Minor Changes
-
--   - Enable Gemini implicit caching
-
-### Patch Changes
-
-- Add a 'when to use' section to mode definitions
-- Adds experimental feature to intelligently condense the task context
-- Switch to the new Roo message parser
-- Update announcement to use a @shadcn/ui dialog
-- Requesty: Fix token usage counts
--   - Enable Gemini implicit caching
+- Enable Gemini implicit caching
+- Add "when to use" section to mode definitions to enable better orchestration
+- Add experimental feature to intelligently condense the task context instead of truncating it
+- Fix one of the causes of the gray screen issue (thanks @xyOz-dev!)
+- Focus improvements for better UI interactions (thanks Cline!)
+- Switch to the new Roo message parser for improved performance (thanks Cline!)
+- Enable source maps for improved debugging (thanks @KJ7LNW!)
+- Update OpenRouter provider to use provider-specific model info (thanks @daniel-lxs!)
+- Fix Requesty cost/token reporting (thanks @dtrugman!)
+- Improve command execution UI
+- Add more in-app links to relevant documentation
+- Update the new task tool description and the ask mode custom instructions in the system prompt
+- Add IPC types to roo-code.d.ts
+- Add build VSIX workflow to pull requests (thanks @SmartManoj!)
+- Improve apply_diff tool to intelligently deduce line numbers (thanks @samhvw8!)
+- Fix command validation for shell array indexing (thanks @KJ7LNW!)
+- Handle diagnostics that point at a directory URI (thanks @daniel-lxs!)
+- Fix "Current ask promise was ignored" error (thanks @zxdvd!)
 
 ## [3.16.6] - 2025-05-12