diff --git a/docs/changelog.rst b/docs/changelog.rst
index 402d156..133d650 100644
--- a/docs/changelog.rst
+++ b/docs/changelog.rst
@@ -6,22 +6,37 @@ All notable changes to FastAPI Traffic are documented here.
The format is based on `Keep a Changelog `_,
and this project adheres to `Semantic Versioning `_.
-[0.2.1] - 2026-03-07
+[0.3.0] - 2026-03-17
--------------------
+Added
+^^^^^
+
+- Expanded example scripts with improved docstrings and usage patterns
+- New ``00_basic_usage.py`` example for getting started quickly
+
Changed
^^^^^^^
-- Improved config loader validation using Pydantic schemas
-- Added pydantic>=2.0 as a core dependency
-- Fixed sync wrapper in decorator to properly handle rate limiting
-- Updated pyright settings for stricter type checking
-- Fixed repository URL in pyproject.toml
+- Refactored Redis backend connection handling for improved reliability
+- Updated algorithm implementations with cleaner type annotations
+- Improved config loader validation with stricter Pydantic schemas
+- Enhanced decorator and middleware error handling
+- Reorganized examples directory structure (removed legacy ``basic_usage.py``)
-Removed
-^^^^^^^
+Fixed
+^^^^^
-- Removed unused main.py
+- Redis backend connection pool management edge cases
+- Type annotation inconsistencies across core modules
+
+[0.2.1] - 2026-03-12
+--------------------
+
+Fixed
+^^^^^
+
+- Test assertion bug in ``test_load_rate_limit_config_from_env_missing_limit`` test case within ``test_config_loader.py``.
[0.2.0] - 2026-02-04
--------------------
diff --git a/docs/conf.py b/docs/conf.py
index 1dcdc17..4e9fdb1 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -13,8 +13,8 @@ sys.path.insert(0, str(Path(__file__).parent.parent.resolve()))
project = "fastapi-traffic"
copyright = "2026, zanewalker"
author = "zanewalker"
-release = "0.2.1"
-version = "0.2.1"
+release = "0.3.0"
+version = "0.3.0"
# -- General configuration ---------------------------------------------------
extensions = [