Consolidate documentation dependencies into pyproject.toml

- Added 'docs' optional dependency group in pyproject.toml
- Updated GitHub Actions workflow to use pyproject.toml instead of requirements-docs.txt
- Updated docs/README.md installation instructions
- Removed redundant requirements-docs.txt file
- Single source of truth for all project dependencies

Author: aarora79

.github/workflows/docs.yml

@@ -50,13 +50,13 @@ jobs:
         uses: actions/cache@v4
         with:
           path: ~/.cache/uv
-          key: ${{ runner.os }}-uv-${{ hashFiles('requirements-docs.txt') }}
+          key: ${{ runner.os }}-uv-${{ hashFiles('pyproject.toml') }}
           restore-keys: |
             ${{ runner.os }}-uv-
             
       - name: Install dependencies
         run: |
-          uv pip install --system -r requirements-docs.txt
+          uv pip install --system -e ".[docs]"
           
       - name: Setup Pages
         id: pages

docs/README.md

@@ -8,10 +8,10 @@ This directory contains the MkDocs-based documentation for the MCP Gateway & Reg
 
 ```bash
 # Using uv (recommended)
-uv pip install -r requirements-docs.txt
+uv pip install -e ".[docs]"
 
 # Or using pip
-pip install -r requirements-docs.txt
+pip install -e ".[docs]"
 ```
 
 ### Development Server

pyproject.toml

@@ -50,6 +50,13 @@ dev = [
     "faker>=24.0.0",
     "freezegun>=1.4.0",
 ]
+docs = [
+    "mkdocs>=1.5.0",
+    "mkdocs-material>=9.4.0",
+    "mkdocs-git-revision-date-localized-plugin>=1.2.0",
+    "mkdocs-minify-plugin>=0.7.0",
+    "pymdown-extensions>=10.0.0",
+]
 
 [tool.setuptools]
 packages = ["registry"]