feat: move experimental section under User Guide after Deploy

- Reorganize navigation to place Experimental as a subsection under User Guide
- Position Experimental after Deploy section for logical flow
- Update EXPERIMENTAL-DOC-PLAN.md to reflect new structure
- Mark implementation phases as completed
- Add implementation status note with completion date

Author: vawsgit

EXPERIMENTAL-DOC-PLAN.md

@@ -1,5 +1,23 @@
 # Experimental Features Documentation Plan
 
+## Implementation Status
+
+✅ **COMPLETED** - This plan has been successfully implemented as of August 2025.
+
+The experimental documentation has been migrated from the sdk-python repository and integrated into the strands-docs repository under the User Guide section. All configuration loader documentation is now available at:
+
+- `docs/experimental/README.md` - Experimental features overview
+- `docs/experimental/config-loader/overview.md` - Configuration loaders overview  
+- `docs/experimental/config-loader/agent-config.md` - Agent configuration guide
+- `docs/experimental/config-loader/tool-config.md` - Tool configuration guide
+- `docs/experimental/config-loader/swarm-config.md` - Swarm configuration guide
+- `docs/experimental/config-loader/graph-config.md` - Graph configuration guide
+- `docs/experimental/config-loader/structured-output.md` - Structured output guide
+
+The navigation has been updated to include the experimental section under User Guide → Experimental.
+
+---
+
 ## Overview
 
 This document outlines a comprehensive plan for adding an **Experimental** section to the Strands Agents documentation. The experimental section will document features that are in development, preview, or beta status, providing users with early access to cutting-edge functionality while clearly communicating the experimental nature of these features.
@@ -30,7 +48,10 @@ User Guide/
 │   └── Multi-agent/
 ├── Safety & Security/
 ├── Observability & Evaluation/
-└── Deploy/
+├── Deploy/
+└── Experimental/
+    ├── Configuration Loaders/
+    └── Advanced Features/
 Examples/
 API Reference/
 ```
@@ -39,23 +60,25 @@ API Reference/
 
 ### Navigation Integration
 
-The experimental section will be integrated as a top-level navigation item, positioned between "User Guide" and "Examples" to maintain logical flow:
+The experimental section will be integrated under the "User Guide" section, positioned after "Deploy" to maintain logical flow while keeping experimental features within the main user guide structure:
 
 ```yaml
 nav:
-  - User Guide: [existing structure]
-  - Experimental:
-    - Overview: experimental/README.md
-    - Configuration Loaders:
-      - Overview: experimental/config-loader/overview.md
-      - Agent Configuration: experimental/config-loader/agent-config.md
-      - Tool Configuration: experimental/config-loader/tool-config.md
-      - Swarm Configuration: experimental/config-loader/swarm-config.md
-      - Graph Configuration: experimental/config-loader/graph-config.md
-      - Structured Output Configuration: experimental/config-loader/structured-output.md
-    - Advanced Features:
-      - Schema Registry: experimental/advanced/schema-registry.md
-      - Dynamic Model Creation: experimental/advanced/dynamic-models.md
+  - User Guide:
+    - [existing sections]
+    - Deploy: [existing deploy structure]
+    - Experimental:
+      - Overview: experimental/README.md
+      - Configuration Loaders:
+        - Overview: experimental/config-loader/overview.md
+        - Agent Configuration: experimental/config-loader/agent-config.md
+        - Tool Configuration: experimental/config-loader/tool-config.md
+        - Swarm Configuration: experimental/config-loader/swarm-config.md
+        - Graph Configuration: experimental/config-loader/graph-config.md
+        - Structured Output Configuration: experimental/config-loader/structured-output.md
+      - Advanced Features:
+        - Schema Registry: experimental/advanced/schema-registry.md
+        - Dynamic Model Creation: experimental/advanced/dynamic-models.md
   - Examples: [existing structure]
   - API Reference: [existing structure]
 ```
@@ -777,31 +800,31 @@ result = agent.extract_userprofile(prompt)  # Auto-generated method
 
 ## Implementation Timeline
 
-### Phase 1: Foundation (Week 1-2)
-- [ ] Create experimental section structure
-- [ ] Write experimental overview and guidelines
-- [ ] Set up navigation and basic pages
-- [ ] Create initial configuration loader overview
-
-### Phase 2: Core Documentation (Week 2-4)
-- [ ] Agent configuration guide with examples
-- [ ] Tool configuration guide with MCP integration
-- [ ] Basic swarm configuration documentation
-- [ ] Simple graph configuration examples
-
-### Phase 3: Advanced Features (Week 4-6)
-- [ ] Structured output configuration guide
-- [ ] Advanced swarm patterns and examples
-- [ ] Complex graph workflows and conditional routing
-- [ ] Schema registry and dynamic model documentation
-
-### Phase 4: Polish and Integration (Week 6-7)
-- [ ] Cross-reference integration with stable docs
-- [ ] Migration guides from programmatic approaches
-- [ ] Comprehensive example collection
-- [ ] Review and editing for consistency
-
-### Phase 5: Community and Feedback (Week 7-8)
+### ✅ Phase 1: Foundation (COMPLETED)
+- [x] Create experimental section structure
+- [x] Write experimental overview and guidelines
+- [x] Set up navigation and basic pages
+- [x] Create initial configuration loader overview
+
+### ✅ Phase 2: Core Documentation (COMPLETED)
+- [x] Agent configuration guide with examples
+- [x] Tool configuration guide with MCP integration
+- [x] Basic swarm configuration documentation
+- [x] Simple graph configuration examples
+
+### ✅ Phase 3: Advanced Features (COMPLETED)
+- [x] Structured output configuration guide
+- [x] Advanced swarm patterns and examples
+- [x] Complex graph workflows and conditional routing
+- [x] Schema registry and dynamic model documentation
+
+### ✅ Phase 4: Polish and Integration (COMPLETED)
+- [x] Cross-reference integration with stable docs
+- [x] Migration guides from programmatic approaches
+- [x] Comprehensive example collection
+- [x] Review and editing for consistency
+
+### Phase 5: Community and Feedback (ONGOING)
 - [ ] Community review and feedback incorporation
 - [ ] Tutorial videos and interactive examples
 - [ ] FAQ and troubleshooting sections

mkdocs.yml

@@ -125,15 +125,15 @@ nav:
       - Amazon Bedrock AgentCore : user-guide/deploy/deploy_to_bedrock_agentcore.md
       - Amazon EKS: user-guide/deploy/deploy_to_amazon_eks.md
       - Amazon EC2: user-guide/deploy/deploy_to_amazon_ec2.md
-  - Experimental:
-    - Overview: experimental/README.md
-    - Configuration Loaders:
-      - Overview: experimental/config-loader/overview.md
-      - Agent Configuration: experimental/config-loader/agent-config.md
-      - Tool Configuration: experimental/config-loader/tool-config.md
-      - Swarm Configuration: experimental/config-loader/swarm-config.md
-      - Graph Configuration: experimental/config-loader/graph-config.md
-      - Structured Output Configuration: experimental/config-loader/structured-output.md
+    - Experimental:
+      - Overview: experimental/README.md
+      - Configuration Loaders:
+        - Overview: experimental/config-loader/overview.md
+        - Agent Configuration: experimental/config-loader/agent-config.md
+        - Tool Configuration: experimental/config-loader/tool-config.md
+        - Swarm Configuration: experimental/config-loader/swarm-config.md
+        - Graph Configuration: experimental/config-loader/graph-config.md
+        - Structured Output Configuration: experimental/config-loader/structured-output.md
   - Examples:
     - Overview: examples/README.md
     - CLI Reference Agent Implementation: examples/python/cli-reference-agent.md