1. Moved check-docs-drift.py to tests/ — the script is now at tests/check-docs-drift.py and the CI workflow triggers on changes to that path.

2. Replaced inline save_to_file=False/log_level="error" arguments with environment variables — CODECARBON_SAVE_TO_FILE=false and CODECARBON_LOG_LEVEL=error are now set at the top of the test script, so the doc examples themselves stay clean and uncluttered.

3. Reduced the number of skipped blocks — the task manager example in usage.md was skippable only because it was missing an import; adding from codecarbon import EmissionsTracker made it runnable. The remaining # skip blocks (TensorFlow examples, Comet integration, Prometheus/Logfire output) are unavoidable due to missing dependencies. Skip comments now explain why each block is excluded.

Author: cianc

docs/getting-started/api.md

@@ -33,7 +33,6 @@ codecarbon monitor
 Or use the API in your code:
 
 ```python
-# skip
 from codecarbon import track_emissions
 
 @track_emissions(save_to_api=True)

docs/getting-started/comet.md

@@ -25,7 +25,7 @@ In the
 example file, replace the placeholder code with your API key:
 
 ```python
-# skip
+# skip testing this with mkdoctests - would require making comet_ml a doc dependency which is overkill.
 experiment = Experiment(api_key="YOUR API KEY")
 ```
 

docs/getting-started/examples.md

@@ -14,7 +14,9 @@ But you can't get them in your code, see the Context Manager section
 below for that.
 
 ```python
-# skip
+# skip mktestdocs testing because a) we would need to add the large tensorflow package as a doc
+# dependency, which would slow down CI setup time, b) these snippets do quiet a lot of work which 
+# would slow things down further.
 import tensorflow as tf
 from codecarbon import track_emissions
 
@@ -51,7 +53,9 @@ We think this is the best way to use CodeCarbon. Still only two lines of
 code, and you can get the emissions in your code.
 
 ```python
-# skip
+# skip mktestdocs testing because a) we would need to add the large tensorflow package as a doc
+# dependency, which would slow down CI setup time, b) these snippets do quiet a lot of work which 
+# would slow things down further.
 import tensorflow as tf
 
 from codecarbon import EmissionsTracker
@@ -98,7 +102,9 @@ background after your computation code has crashed, so your program will
 never finish.
 
 ```python
-# skip
+# skip mktestdocs testing because a) we would need to add the large tensorflow package as a doc
+# dependency, which would slow down CI setup time, b) these snippets do quiet a lot of work which 
+# would slow things down further.
 import tensorflow as tf
 
 from codecarbon import EmissionsTracker

docs/getting-started/usage.md

@@ -147,7 +147,7 @@ tracking of the compute section.
 
 ```python
 from codecarbon import EmissionsTracker
-tracker = EmissionsTracker(save_to_file=False, log_level="error")
+tracker = EmissionsTracker()
 tracker.start()
 try:
      # Compute intensive code goes here
@@ -168,14 +168,15 @@ If you want to monitor small piece of code, like a model inference, you
 could use the task manager:
 
 ```python
-# skip
+from codecarbon import EmissionsTracker
+
 try:
     tracker = EmissionsTracker(project_name="bert_inference", measure_power_secs=10)
     tracker.start_task("load dataset")
-    dataset = load_dataset("imdb", split="test")
+    # do some data loading
     imdb_emissions = tracker.stop_task()
     tracker.start_task("build model")
-    model = build_model()
+    # build some model
     model_emissions = tracker.stop_task()
 finally:
     _ = tracker.stop()
@@ -197,7 +198,7 @@ The `Emissions tracker` also works as a context manager.
 ```python
 from codecarbon import EmissionsTracker
 
-with EmissionsTracker(save_to_file=False, log_level="error") as tracker:
+with EmissionsTracker() as tracker:
     _ = 1 + 1  # Compute intensive training code goes here
 ```
 
@@ -213,7 +214,7 @@ emissions of the training code.
 ```python
 from codecarbon import track_emissions
 
-@track_emissions(save_to_file=False, log_level="error")
+@track_emissions
 def training_loop():
     # Compute intensive training code goes here
     pass
@@ -243,7 +244,7 @@ emissions as follows:
 
 ```python
 from codecarbon import OfflineEmissionsTracker
-tracker = OfflineEmissionsTracker(country_iso_code="CAN", save_to_file=False, log_level="error")
+tracker = OfflineEmissionsTracker(country_iso_code="CAN")
 tracker.start()
 # GPU intensive training code
 tracker.stop()
@@ -256,7 +257,7 @@ The `OfflineEmissionsTracker` also works as a context manager
 ```python
 from codecarbon import OfflineEmissionsTracker
 
-with OfflineEmissionsTracker(country_iso_code="CAN", save_to_file=False, log_level="error") as tracker:
+with OfflineEmissionsTracker(country_iso_code="CAN") as tracker:
     # GPU intensive training code goes here
     pass
 ```
@@ -273,7 +274,7 @@ parameters:
 
 ```python
 from codecarbon import track_emissions
-@track_emissions(offline=True, country_iso_code="CAN", save_to_file=False, log_level="error")
+@track_emissions(offline=True, country_iso_code="CAN")
 def training_loop():
     # training code goes here
     pass
@@ -338,7 +339,7 @@ CodeCarbon is structured so that you can configure it in a hierarchical manner:
         parameter is set in both:
 
         ```python
-        # skip
+        # skip this block for mktestdocs testing because it tries to call APIs
         EmissionsTracker(
            api_call_interval=4,
            save_to_api=True,

docs/index.md

@@ -38,7 +38,7 @@ Only a few lines of code:
 ```python
 from codecarbon import EmissionsTracker
 
-tracker = EmissionsTracker(save_to_file=False, log_level="error")
+tracker = EmissionsTracker()
 tracker.start()
 
 # Your code here

pyproject.toml

@@ -145,7 +145,7 @@ test-coverage = "CODECARBON_ALLOW_MULTIPLE_RUNS=True pytest --cov --cov-report=x
 test-package-integ = "CODECARBON_ALLOW_MULTIPLE_RUNS=True python -m pytest -vv tests/"
 docs = "zensical build -f mkdocs.yml"
 docs-serve = "zensical serve -f mkdocs.yml"
-docs-check-drift = "pytest scripts/check-docs-drift.py -v"
+docs-check-drift = "pytest tests/check-docs-drift.py -v"
 carbonboard = "python codecarbon/viz/carbonboard.py"
 
 [tool.bumpver]

scripts/check-docs-drift.py tests/check-docs-drift.pyscripts/check-docs-drift.py renamed to tests/check-docs-drift.py

@@ -4,15 +4,20 @@
 Blocks whose first line is '# skip' are intentionally excluded
 (e.g. examples requiring external services or heavy dependencies).
 
-Run with: pytest scripts/check-docs-drift.py -v
+Run with: pytest tests/check-docs-drift.py -v
 """
 
+import os
 import pathlib
 
 import pytest
 from mktestdocs import grab_code_blocks
 from mktestdocs.__main__ import exec_python
 
+# Suppress CSV output and log noise when tracker examples run in CI.
+os.environ["CODECARBON_SAVE_TO_FILE"] = "false"
+os.environ["CODECARBON_LOG_LEVEL"] = "error"
+
 
 @pytest.mark.parametrize("fpath", pathlib.Path("docs").glob("**/*.md"), ids=str)
 def test_doc_file(fpath):