diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index d8177ac..1f63e64 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -239,7 +239,7 @@ def example_method(self):
 # Add: Comprehensive guide to device state management
 
 ## Changes
-- New document: `docs/core-concepts/state-management.md`
+- New document: `docs/concepts/state-management.md`
 - Covers state types, update patterns, and performance
 - Includes 5 code examples
 - Links to related API reference docs
diff --git a/README.md b/README.md
index a1c0903..5f65818 100644
--- a/README.md
+++ b/README.md
@@ -84,21 +84,21 @@ Community-contributed guides and resources:
 
 All documentation is organized in the `docs/` directory:
 
-### 📚 [Getting Started](docs/getting-started/)
+### 📚 [Quick Start](docs/quick-start.md)
 New to Indigo plugin development? Start here!
 - Setting up your development environment
 - Creating your first plugin
 - Understanding plugin structure
 - Testing and debugging
 
-### 🏗️ [Core Concepts](docs/core-concepts/)
+### 🏗️ [Core Concepts](docs/concepts/)
 Understanding the architecture and lifecycle
 - Plugin lifecycle (init, startup, shutdown)
 - Device types (custom, relay, dimmer, sensor, thermostat)
 - State management
 - Concurrent thread patterns
 
-### 📖 [API Reference](docs/api-reference/)
+### 📖 [API Reference](docs/api/)
 Detailed API documentation
 - Plugin base class methods
 - Device object properties