readthedocs changes made

Author: muditbhargava66

.readthedocs.yaml

@@ -1,49 +1,26 @@
 # .readthedocs.yaml
+# ReadTheDocs configuration for SerDes Validation Framework
 version: 2
 
 build:
   os: ubuntu-22.04
   tools:
     python: "3.10"
   jobs:
-    pre_create_environment:
-      # Set up mock mode for documentation builds
-      - echo "SVF_MOCK_MODE=1" >> $READTHEDOCS_VIRTUALENV_PATH/bin/activate
     post_install:
-      # Ensure mock mode is available during doc generation
       - export SVF_MOCK_MODE=1
 
 sphinx:
   configuration: docs/conf.py
-  fail_on_warning: false  # Allow warnings for mock imports
-  builder: html
+  fail_on_warning: false
 
 python:
   install:
     - method: pip
       path: .
       extra_requirements:
         - docs
-        - dev  # Include development dependencies for mock support
     - requirements: docs/requirements.txt
 
-# Build formats
 formats:
-  - pdf
-  - epub
-  - htmlzip
-
-# Search configuration
-search:
-  ranking:
-    api/*: 2
-    tutorials/*: 3
-    guides/*: 1
-    examples/*: 1
-
-# Subprojects for versioning
-subprojects:
-  include:
-    - usb4-api
-    - mock-testing
-    - reporting-system
+  - htmlzip

docs/conf.py

@@ -33,20 +33,12 @@
 
 extensions = [
     'sphinx.ext.autodoc',
-    'sphinx.ext.autosummary',
     'sphinx.ext.viewcode',
     'sphinx.ext.napoleon',
     'sphinx.ext.intersphinx',
-    'sphinx.ext.todo',
-    'sphinx.ext.coverage',
-    'sphinx.ext.mathjax',
-    'sphinx.ext.ifconfig',
-    'sphinx.ext.githubpages',
+    'myst_parser',
+    'sphinx_copybutton',
     'sphinxcontrib.mermaid',
-    'myst_parser',  # For Markdown support
-    'sphinx_rtd_theme',
-    'sphinx.ext.graphviz',
-    'sphinx_copybutton',  # Copy button for code blocks
 ]
 
 # Add any paths that contain templates here, relative to this directory.

docs/requirements.txt

@@ -1,32 +1,20 @@
-# Documentation build requirements
+# Documentation build requirements for ReadTheDocs
 
-# Sphinx and extensions
-sphinx>=5.0.0
-sphinx-rtd-theme>=1.2.0
-myst-parser>=0.18.0
+# Core Sphinx
+sphinx>=4.0.0,<7.0.0
+sphinx-rtd-theme>=1.0.0
+myst-parser>=0.18.1
 sphinx-copybutton>=0.5.0
-sphinx-autobuild>=2021.3.14
 
-# Additional Sphinx extensions
+# Sphinx extensions
 sphinxcontrib-mermaid>=0.7.1
-sphinxcontrib-plantuml>=0.24
-sphinx-tabs>=3.4.0
 sphinx-design>=0.3.0
 
-# Documentation utilities
-doc8>=0.11.0
-rstcheck>=6.0.0
-
-# Framework dependencies (for autodoc)
+# Framework dependencies (minimal for autodoc)
 numpy>=1.21.0
 scipy>=1.7.0
 pandas>=1.3.0
 matplotlib>=3.5.0
-pyyaml>=6.0
-click>=8.0
-tqdm>=4.62.0
-structlog>=21.1.0
 
-# Mock dependencies for documentation builds
-mock>=4.0.0
-pytest>=7.0.0
+# Mock support for documentation builds
+mock>=4.0.0