Updated docs for recent updates

Author: jongalloway

README.md

@@ -224,11 +224,15 @@ app.MapNLWebNet();     // Map NLWebNet minimal API endpoints
 
 5. **Test the demo features**
    - **Home Page**: Overview and navigation to demo features
-   - **Interactive Demo** (`/nlweb`): UI for testing NLWeb queries
-     - Query input with natural language questions
-     - Mode selection (List, Summarize, Generate)
-     - Streaming responses with real-time display
-     - API testing interface
+   - **Interactive Demo** (`/nlweb`): UI for testing NLWeb queries with enhanced data source visualization
+     - **Smart Data Source Management**: Automatic routing between RSS feeds (.NET content), Schema.org static data (science fiction), and mock placeholders
+     - **Visual Data Source Indicators**: Top-level Bootstrap cards showing which sources are active
+     - **User Guidance Prompts**: Contextual examples of what content is available to search
+     - **Query input with natural language questions**: Try ".NET 9 features" for RSS data or "space movies" for sci-fi content
+     - **Mode selection**: List, Summarize, Generate modes with streaming support
+     - **Color-coded result badges**: Each result shows its source (RSS/Schema.org/Mock) with visual indicators
+     - **HTML tag removal**: Clean display of RSS feed content
+     - **API testing interface**: Direct endpoint testing with request/response inspection
    - **API Documentation**: OpenAPI specification for `/ask` and `/mcp` endpoints
 
 > **🔧 Real AI Integration**: The demo uses mock responses by default. For actual AI-powered responses, see the [Complete Setup Guide](doc/demo-setup-guide.md) for Azure OpenAI and OpenAI API integration.
@@ -337,13 +341,14 @@ The demo application works with mock responses by default, but can be configured
 📖 **[Complete AI Integration Guide](doc/demo-setup-guide.md)** - Step-by-step instructions for:
 
 - Azure OpenAI and OpenAI API configuration
+- Enhanced data source features and testing scenarios
 - Security best practices for API key management
 - Service registration and dependency injection
 - Troubleshooting common setup issues
 - Configuration options
 - Production deployment considerations
 
-The guide includes examples, FAQ, and troubleshooting to get you up and running with AI responses.
+The guide includes examples, FAQ, troubleshooting, and detailed documentation of the enhanced data source visualization features.
 
 ## ⚙️ Configuration
 

doc/demo-setup-guide.md

@@ -6,6 +6,7 @@ This guide provides step-by-step instructions for configuring and testing the NL
 
 ## Table of Contents
 
+- [Enhanced Data Source Features](#enhanced-data-source-features)
 - [Prerequisites](#prerequisites)
 - [Option 1: Azure OpenAI Setup (Recommended)](#option-1-azure-openai-setup-recommended)
 - [Option 2: OpenAI API Setup](#option-2-openai-api-setup)
@@ -20,6 +21,51 @@ This guide provides step-by-step instructions for configuring and testing the NL
 - [Production Deployment Notes](#production-deployment-notes)
 - [Frequently Asked Questions](#frequently-asked-questions)
 
+## Enhanced Data Source Features
+
+The NLWebNet demo application includes sophisticated data source management with strict isolation and visual indicators:
+
+### 🎯 **Smart Data Source Routing**
+
+The demo uses an **Enhanced Mock Data Backend** that intelligently routes queries to different data sources based on LLM availability and query content:
+
+- **When LLM is configured**:
+  - **.NET queries** (containing ".NET", "release", "update", etc.) → **RSS feed data** from Microsoft .NET Blog
+  - **General queries** (space, movies, AI, etc.) → **Static science fiction content** with Schema.org markup
+- **When LLM is not configured**:
+  - **All queries** → **Mock placeholder data** for demonstration
+
+### 🎨 **Visual Data Source Indicators**
+
+The demo UI features prominent Bootstrap cards at the top of results showing:
+
+- **🔵 RSS Feeds**: Live .NET blog content (blue primary theme)
+- **🟢 Schema.org Static Data**: Science fiction content (info blue theme)  
+- **🟡 Mock Data**: Placeholder content (warning yellow theme)
+
+Each indicator shows the count of results from that source and is highlighted when active.
+
+### 🏷️ **Result Source Labels**
+
+Every search result includes color-coded badges showing its data source:
+- **RSS badge** (blue): Live RSS feed content
+- **Schema.org badge** (info blue): Static structured data
+- **Mock badge** (yellow): Placeholder content
+
+### 🧹 **Clean Content Display**
+
+- **HTML Tag Removal**: RSS feed content automatically strips HTML tags for clean display
+- **Zero Cross-Contamination**: Robust backend logic ensures no mixing of data sources
+- **Science Fiction Theme**: Static content features movies, spacecraft, exoplanets, and futuristic technology
+
+### 💡 **User Guidance**
+
+When AI is configured, the demo shows helpful prompts with examples:
+- **".NET Content"**: Try ".NET 9", "ASP.NET updates", "C# features"
+- **"Science Fiction"**: Try "space movies", "Mars exploration", "AI stories"
+
+This design helps users understand what content is available and demonstrates clean data source separation for NLWeb protocol implementation.
+
 ## Prerequisites
 
 - .NET 9 SDK installed
@@ -227,6 +273,36 @@ Since NLWebNet uses `Microsoft.Extensions.AI`, you need to install the appropria
    - Click "Submit Query"
    - **Expected**: Full AI-generated response with citations
 
+### Enhanced Data Source Testing
+
+The demo features sophisticated data source management. Test these scenarios to see the intelligent routing:
+
+1. **Test .NET Content Routing**:
+   - Enter queries: ".NET 9 features", "ASP.NET updates", "C# release notes"
+   - **Expected**: Results show RSS badges and come from devblogs.microsoft.com
+   - **Visual**: Top data source card shows "Live RSS Feeds" as active (blue highlight)
+   - **Note**: HTML tags are automatically stripped from RSS content for clean display
+
+2. **Test Science Fiction Content Routing**:
+   - Enter queries: "space movies", "Mars exploration", "AI stories", "exoplanets"
+   - **Expected**: Results show Schema.org badges with sci-fi themed content
+   - **Visual**: Top data source card shows "Schema.org Static Data" as active (info blue highlight)
+   - **Content**: Movies like Blade Runner 2049, spacecraft like Millennium Falcon, etc.
+
+3. **Test Mock Data Mode** (AI not configured):
+   - If no AI is configured, any query returns mock placeholder data
+   - **Expected**: Results show Mock badges with placeholder content
+   - **Visual**: Top data source card shows "Mock Data" as active (warning yellow highlight)
+
+4. **Verify Data Source Isolation**:
+   - Check that .NET queries never show sci-fi content
+   - Check that general queries never show RSS feed content
+   - Each result card shows the correct color-coded badge (RSS/Schema.org/Mock)
+
+5. **Test User Guidance Prompts**:
+   - When AI is configured, see helpful example prompts above the query box
+   - Examples show what content is available for .NET vs Science Fiction queries
+
 ### Streaming Testing
 
 1. **Go to Streaming Tab**:

doc/todo.md

@@ -81,6 +81,16 @@ The NLWebNet library is now fully functional and feature complete with a modern
 
 **📚 DOCUMENTATION MILESTONE: Complete Setup Guide** - Comprehensive demo setup guide (`doc/demo-setup-guide.md`) provides end-to-end instructions for integrating real AI services (Azure OpenAI, OpenAI API) with detailed troubleshooting, security considerations, and production deployment guidance.
 
+**🎨 UI/UX ENHANCEMENT: Advanced Data Source Visualization** - Enhanced demo application with sophisticated data source management and visualization:
+- ✅ **Enhanced Mock Data Backend**: Implemented strict data source isolation with `EnhancedMockDataBackend` service
+- ✅ **Data Source Indicators**: Top-level Bootstrap cards showing RSS feeds, Schema.org static data, and mock data sources
+- ✅ **Smart Content Routing**: .NET queries return RSS feed data, general queries return science fiction content, no AI returns mock data
+- ✅ **HTML Tag Removal**: Automatic HTML stripping for RSS content display
+- ✅ **Visual Data Source Labels**: Color-coded badges on each result showing source (RSS/Schema.org/Mock)
+- ✅ **User Guidance Prompts**: Contextual examples showing users what content is available for search
+- ✅ **Zero Cross-Contamination**: Robust logging and detection to ensure pure data source isolation
+- ✅ **Science Fiction Theme**: Complete replacement of Microsoft product references with sci-fi content for clean demo data
+
 **The project has successfully completed all planned phases** with a fully functional demonstration application running at `http://localhost:5037`, a published NuGet package available at [nuget.org/packages/NLWebNet](https://www.nuget.org/packages/NLWebNet/), confirmed extension method accessibility, comprehensive configuration and testing infrastructure, and complete documentation for real-world AI integration.
 
 ## Implementation Plan