fix: build timeout for readthedocs (#5744)

* Update v3 readthedocs to autorender all submodules

* Maintain previous opinionated list, add new section of full module reference

* Add sagemaker-core description in init

* Remove pdf and epub from format and mock runtime imports to fix build timeout in actual publishing attempt

* Remove pdf and epub from format and mock runtime imports to fix build timeout in actual publishing attempt

Author: mollyheamazon

.readthedocs.yaml

@@ -11,9 +11,7 @@ build:
 sphinx:
   configuration: docs/conf.py
 
-formats:
-  - pdf
-  - epub
+formats: []
 
 python:
   install:

docs/conf.py

@@ -105,6 +105,25 @@
     'sagemaker.serve.model_server.torchserve.inference',
     'sagemaker.serve.model_server.torchserve.xgboost_inference',
     'sagemaker.serve.model_server.triton.model',
+    # Heavy runtime dependencies — mock to avoid slow/failing imports during doc build
+    'boto3',
+    'botocore',
+    'torch',
+    'tensorflow',
+    'sklearn',
+    'numpy',
+    'pandas',
+    'scipy',
+    'xgboost',
+    'lightgbm',
+    'mlflow',
+    'pyspark',
+    'transformers',
+    'datasets',
+    'trl',
 ]
 
 suppress_warnings = ['autodoc.import_error']
+
+# Speed up builds: only regenerate autosummary stubs if they don't exist
+autosummary_generate_overwrite = False