Doc for v1.4 (#177)

* updated main readme

* fixed links

* update links

* updates

Author: remi-td

README.md

@@ -3,7 +3,7 @@
 ## Overview
 The Teradata MCP server provides sets of tools and prompts, grouped as modules for interacting with Teradata databases. Enabling AI agents and users to query, analyze, and manage their data efficiently. 
 
-
+![Getting Started](https://raw.githubusercontent.com/Teradata/teradata-mcp-server/main/docs/media/client-server-platform.png)
 
 ## Key features
 
@@ -27,7 +27,7 @@ We are providing groupings of tools and associated helpful prompts to support al
   - [Security Tools](https://github.com/Teradata/teradata-mcp-server/blob/main/src/teradata_mcp_server/tools/sec/README.md)
 
 ## Quick start with Claude Desktop (no installation)
-
+> Prefer to use other tools? Check out our Quick Starts for [VS Code/Copilot](https://github.com/Teradata/teradata-mcp-server/blob/main/docs/server_guide/QUICK_START_VSCODE.md), [Open WebUI](https://github.com/Teradata/teradata-mcp-server/blob/main/docs/server_guide/QUICK_START_OPEN_WEBUI.md), or dive into [simple code examples](https://github.com/Teradata/teradata-mcp-server/blob/main/examples/README.md#client-applications)!
 You can use Claude Desktop to give the  Teradata MCP server a quick try, Claude can manage the server in the background using `uv`. No permanent installation needed.
 
 **Pre-requisites**
@@ -53,17 +53,17 @@ Configure the claude_desktop_config.json (Settings>Developer>Edit Config) by add
 
 ## Setting up your environment
 
-![Getting Started](https://raw.githubusercontent.com/Teradata/teradata-mcp-server/main/docs/media/MCP-quickstart.png)
+Follow this process to install your server, connect it to your Teradata platform and integrated your tools.
 
 **Step 1.** - Identify the running Teradata System, you need username, password and host details. If you do not have a Teradata system to connect to, then leverage [Teradata Clearscape Experience](https://www.teradata.com/getting-started/demos/clearscape-analytics)
 
 **Step 2.** - To install, configure and run the MCP server, refer to the [Getting started guide](https://github.com/Teradata/teradata-mcp-server/blob/main/docs/server_guide/GETTING_STARTED.md), or see below for a quick [CLI installation](#CLI-Installation). You can easily [customize the server with your own tools, prompts and resources](docs/server_guide/CUSTOMIZING.md).
 
-**Step 3.** - There are many client options available, the [Client Guide](https://github.com/Teradata/teradata-mcp-server/blob/main/docs/client_guide/CLIENT_GUIDE.md) explains how to configure and run a sample of different clients.
+**Step 3.** - There are many client options available, the [Client Guide](https://github.com/Teradata/teradata-mcp-server/blob/main/docs/README.md#-client-guide) explains how to configure and run a sample of different clients.
 
 <br>
 
-Check out our libraries of [curated examples](https://github.com/Teradata/teradata-mcp-server/blob/main/examples/) or [video guides](https://github.com/Teradata/teradata-mcp-server/blob/main/docs/VIDEO_LIBRARY.md).
+Check out our [documentation](https://github.com/Teradata/teradata-mcp-server/blob/main/docs/README.md) and libraries of [curated examples](https://github.com/Teradata/teradata-mcp-server/blob/main/examples/) or [video guides](https://github.com/Teradata/teradata-mcp-server/blob/doc-v1.4/docs/server_guide/VIDEO_LIBRARY.md).
 
 <br>
 

docs/README.md

@@ -11,7 +11,7 @@ New to Teradata MCP Server? Choose your 5-minute quickstart to rapidly evaluate
 | [Claude Desktop](server_guide/QUICK_START.md) | CLI (uv/pipx) | stdio | Exploratory Data Analytics, Platform Administration, general evaluation |
 | [VS Code + Copilot](server_guide/QUICK_START_VSCODE.md) | CLI (uv/pipx) | HTTP | Data Engineering, Agentic app development |
 | [Open WebUI](server_guide/QUICK_START_OPEN_WEBUI.md) | Docker | REST | Local AI, evaluate new LLMs |
-| [Code examples](examples/README.md) | Python | HTTP | Build your own client. Example library using ADK, Bedrock, Langchain... |
+| [Code examples](../examples/README.md) | Python | HTTP | Build your own client. Example library using ADK, Bedrock, Langchain... |
 
 **Other Options:**
 - **[Getting Started Guide](server_guide/GETTING_STARTED.md)** - Detailed path selection and role-based recommendations

docs/server_guide/GETTING_STARTED.md

@@ -8,35 +8,20 @@ Welcome to the Teradata MCP Server! This guide helps you choose the right starti
 
 ### 🚀 **Just Want to Try It? (5 minutes)**
 
-#### **Option A: Claude Desktop**
-**→ [Quick Start (Claude Desktop)](QUICK_START.md)**
+New to Teradata MCP Server? Choose your 5-minute quickstart to rapidly evaluate the server with your favorite tool:
 
-Perfect for:
-- First-time users and evaluation
-- AI chat and data exploration
-- Desktop-based data analysis
-
-#### **Option B: VS Code & GitHub Copilot**  
-**→ [Quick Start (VS Code)](QUICK_START_VSCODE.md)**
-
-Perfect for:
-- VS Code and GitHub Copilot users
-- Development workflows in your IDE
-- Code completion with Teradata context
-
-#### **Option C: Open WebUI**  
-**→ [Quick Start (Open WebUI)](QUICK_START_OPEN_WEBUI.md)**
-
-Perfect for:
-- Self-hosted web interface users
-- Team sharing and collaboration
-- Integration with various LLM models
+| **Client** | **Deployment** | **Communication** | **Best For** |
+|------------|----------------|------------------|--------------|
+| [Claude Desktop](server_guide/QUICK_START.md) | CLI (uv/pipx) | stdio | Exploratory Data Analytics, Platform Administration, general evaluation |
+| [VS Code + Copilot](server_guide/QUICK_START_VSCODE.md) | CLI (uv/pipx) | HTTP | Data Engineering, Agentic app development |
+| [Open WebUI](server_guide/QUICK_START_OPEN_WEBUI.md) | Docker | REST | Local AI, evaluate new LLMs |
+| [Code examples](../examples/README.md) | Python | HTTP | Build your own client. Example library using ADK, Bedrock, Langchain... |
 
 *All options get you running in 5 minutes with minimal configuration.*
 
 ---
 
-### 🏗 **Setting Up for Production? (15 minutes)**  
+### 🏗 **Setting Up your environment? (15 minutes)**  
 **→ [Installation Guide](INSTALLATION.md)**
 
 Choose your deployment method:
@@ -45,73 +30,60 @@ Choose your deployment method:
 - **pip + venv** - Traditional Python virtual environments
 - **Source build** - Development and contributions
 
-*Compare options and get detailed setup instructions.*
-
 ---
 
 ### ⚙️ **Need to Configure the Server?**
 **→ [Configuration Guide](CONFIGURATION.md)**
 
-Essential for:
+Reference for:
 - Environment variables and profiles
 - Database connection tuning
 - Transport modes (stdio vs HTTP)
 - Production optimization
 
-*Master all server configuration options.*
-
 ---
 
-### 🔒 **Enterprise Security Setup?**
+### 🔒 **Security Setup?**
 **→ [Security Guide](SECURITY.md)**
 
-Required for:
-- Team deployments
-- User authentication
-- Audit compliance
-- Production security
-
-*Implement authentication and access control.*
+Reference guide for:
+- Securing a remote server deployment
+- Implementing user authentication
+- Implementing data security
+- Understanding Audit mechanisms
 
 ---
 
-### 🛠 **Want Custom Business Tools?**
+### 🛠 **Want to Customize Tools, Prompts and Resources for your Business context?**
 **→ [Customization Guide](CUSTOMIZING.md)**
 
+We make it very quick and easy to create your own:
 Create:
 - Domain-specific tools and prompts
 - Business semantic layers
 - Custom cubes and glossaries
-- YAML-based configurations
-
-*Add your business logic without coding.*
+- All in YAML-based configurations
 
 ---
 
-### 👥 **Ready to Connect AI Clients?**
+### 👥 **Connect AI Clients?**
 **→ [Client Guide](../client_guide/CLIENT_GUIDE.md)**
 
 Supports:
 - Claude Desktop, VS Code, Google Gemini
 - Web applications and REST APIs
 - Custom MCP client integrations
 
-*Connect your favorite AI tools.*
-
 ## 🏗 Understanding the Architecture
 
-**New to MCP or want to understand how it all works?**
-
 **→ [Architecture Overview](ARCHITECTURE.md)**
 
-Learn about:
+This guide gives you an overview of:
 - Component relationships
 - Request flow and security
 - Deployment patterns
 - Integration points
 
-*Understand the big picture before diving in.*
-
 ## 🎬 Prefer Video Learning?
 
 **→ [Video Library](VIDEO_LIBRARY.md)**
@@ -140,9 +112,9 @@ Watch step-by-step tutorials for:
 
 ### By Use Case:
 
-**Personal AI Chat:** [Quick Start (Claude)](QUICK_START.md)  
+**Chat with your data:** [Quick Start (Claude)](QUICK_START.md)  
 **Development/Coding:** [Quick Start (VS Code)](QUICK_START_VSCODE.md)  
-**Team Setup:** [Installation](INSTALLATION.md) + [Security](SECURITY.md)  
+**Organization Setup:** [Installation](INSTALLATION.md) + [Security](SECURITY.md)  
 **Application Integration:** [Installation](INSTALLATION.md) + [Client Guide](../client_guide/CLIENT_GUIDE.md)  
 **Business Customization:** [Quick Start (Claude)](QUICK_START.md) + [Customization](CUSTOMIZING.md)