fix: repair all 37 dead links and mkdocs strict-build config error

Check Links: fixed off-by-one relative path depth bugs (missing a
../ level) across 8 nested docs/ and root files, corrected renamed
notebook filenames in 01_Data_Scientist and 03_AI_Engineer READMEs,
replaced dead external resources (Chip Huyen post removed, GitHub
repos 404, DrivenData/Azure ML paths reorganized, wrong arXiv ID) with
live equivalents, de-linked a hackathon TOC pointing at sections that
were never written, and added mlwave.com (bot-blocking) plus the
idea_template.md arXiv placeholder to mlc_config.json ignorePatterns.

Deploy Documentation: mkdocs 1.6.1 now rejects docs_dir being the
same directory as mkdocs.yml itself. Moved the config into .mkdocs/
with docs_dir: '..' so it resolves to the repo root as before, and
moved site_dir outside docs_dir entirely (../../site) to satisfy the
site_dir-nested-in-docs_dir check too. Verified `mkdocs build --strict`
now exits 0 and markdown-link-check reports 0 dead links across all
130 files.

Author: Viraj97-SL

.github/mlc_config.json

@@ -8,6 +8,12 @@
     },
     {
       "pattern": "^https://teamblind.com"
+    },
+    {
+      "pattern": "^https://mlwave.com"
+    },
+    {
+      "pattern": "^https://arxiv.org/abs/XXXX"
     }
   ],
   "timeout": "20s",

.github/workflows/deploy-docs.yml

@@ -7,7 +7,7 @@ on:
       - main
     paths:
       - '**/*.md'
-      - 'mkdocs.yml'
+      - '.mkdocs/mkdocs.yml'
   workflow_dispatch:
 
 permissions:
@@ -37,12 +37,12 @@ jobs:
         run: pip install mkdocs-material mkdocs-minify-plugin
 
       - name: Build documentation
-        run: mkdocs build --strict
+        run: mkdocs build --strict -f .mkdocs/mkdocs.yml
 
       - name: Upload Pages artifact
         uses: actions/upload-pages-artifact@v3
         with:
-          path: site/
+          path: ../site/
 
   deploy:
     needs: build

mkdocs.yml .mkdocs/mkdocs.ymlmkdocs.yml renamed to .mkdocs/mkdocs.yml

@@ -9,8 +9,8 @@ repo_url: https://github.com/viraj97-sl/ai-ml-ds-learning-hub
 repo_name: viraj97-sl/ai-ml-ds-learning-hub
 edit_uri: edit/master/
 
-docs_dir: '.'
-site_dir: site
+docs_dir: '..'
+site_dir: ../../site
 
 theme:
   name: material
@@ -73,7 +73,6 @@ markdown_extensions:
       permalink: true
 
 exclude_docs: |
-  site/
   venv/
   .venv/
   *.ipynb

00_Overview/salary_guide.md

@@ -153,7 +153,7 @@
 
 ### Research Your Market Value
 1. Check [Levels.fyi](https://levels.fyi) for tech company data points
-2. Use [Glassdoor](https://glassdoor.com), [LinkedIn Salary](https://linkedin.com/salary), [Payscale](https://payscale.com)
+2. Use [Glassdoor](https://glassdoor.com), [LinkedIn Salary](https://linkedin.com/salary), [Payscale](https://www.payscale.com)
 3. Ask peers in communities (Blind, Discord servers, Reddit r/cscareerquestions)
 4. Talk to recruiters — they know market rates
 5. Get multiple offers simultaneously for the strongest leverage

01_Data_Scientist/README.md

@@ -82,8 +82,8 @@ Before starting this track, make sure you have:
 |------|-------|----------|----------|
 | 1-2 | Python for DS refresher | [Python for DS](../04_Foundations/programming/python_for_ds.md) | [Exercises](beginner/01_python_exercises.ipynb) |
 | 3-4 | pandas & NumPy | [Data Manipulation Guide](beginner/02_pandas_numpy.ipynb) | Analyze Titanic dataset |
-| 5-6 | Statistics Foundations | [Stats Guide](../04_Foundations/statistics/) | [Stats Notebook](beginner/03_statistics.ipynb) |
-| 7-8 | Data Visualization | [Visualization Guide](beginner/04_visualization.ipynb) | Create 10 chart types |
+| 5-6 | Statistics Foundations | [Stats Guide](../04_Foundations/statistics/) | [Stats Notebook](beginner/03_statistics_fundamentals.ipynb) |
+| 7-8 | Data Visualization | [Visualization Guide](beginner/04_data_visualization.ipynb) | Create 10 chart types |
 | 9-10 | EDA Workflow | [EDA Notebook](beginner/05_eda_workflow.ipynb) | Full EDA on 2 datasets |
 | 11-12 | SQL for Analysis | [SQL Guide](../04_Foundations/programming/sql_basics.md) | [SQL Exercises](beginner/06_sql_exercises.ipynb) |
 
@@ -114,7 +114,7 @@ Before starting this track, make sure you have:
 | 5-6 | Feature Engineering | [Feature Engineering Guide](intermediate/03_feature_engineering.ipynb) | Engineer 10 new features |
 | 7-8 | Model Evaluation | [Evaluation Metrics](intermediate/04_model_evaluation.ipynb) | Cross-validate 5 models |
 | 9-10 | Ensemble Methods | [Ensembles Guide](intermediate/05_ensemble_methods.ipynb) | XGBoost competition entry |
-| 11-12 | Unsupervised Learning | [Clustering & Dimensionality](intermediate/06_unsupervised.ipynb) | Customer segmentation project |
+| 11-12 | Unsupervised Learning | [Clustering & Dimensionality](intermediate/06_unsupervised_learning.ipynb) | Customer segmentation project |
 | 13-14 | ML Pipelines | [sklearn Pipelines](intermediate/07_ml_pipelines.ipynb) | Build production-ready pipeline |
 
 **[→ Start Intermediate Phase](intermediate/)**
@@ -143,7 +143,7 @@ Before starting this track, make sure you have:
 | 1-3 | Deep Learning Intro | [Deep Learning Guide](advanced/01_deep_learning_intro.ipynb) | Train neural network from scratch |
 | 4-6 | NLP Fundamentals | [NLP Guide](advanced/02_nlp_fundamentals.ipynb) | Sentiment analysis project |
 | 7-9 | Time Series | [Time Series Guide](advanced/03_time_series.ipynb) | Sales forecasting project |
-| 10-12 | A/B Testing & Experimentation | [Experiment Design Guide](advanced/04_ab_testing.ipynb) | Design and analyze experiment |
+| 10-12 | A/B Testing & Experimentation | [Experiment Design Guide](advanced/04_ab_testing_advanced.ipynb) | Design and analyze experiment |
 | 13-15 | Bayesian Statistics | [Bayesian Guide](advanced/05_bayesian_statistics.ipynb) | Bayesian A/B test |
 | 16-18 | Model Interpretability | [XAI Guide](advanced/06_model_interpretability.ipynb) | Explain black-box model |
 | 19-21 | Causal Inference | [Causality Guide](advanced/07_causal_inference.ipynb) | Propensity score matching |

03_AI_Engineer/README.md

@@ -116,10 +116,10 @@ PHASE 4: Expert (Ongoing)
 | 1-3 | LLM Fine-tuning (LoRA/QLoRA + Alignment) | [Fine-tuning Guide](advanced/01_llm_finetuning_alignment.ipynb) | Fine-tune Llama 3 |
 | 4-6 | Multi-agent systems | [Multi-agent Guide](advanced/02_multi_agent_systems.ipynb) | Research + report agent |
 | 7-9 | Advanced Retrieval techniques | [Advanced Retrieval](advanced/04_advanced_retrieval.ipynb) | Multi-strategy retrieval |
-| 10-12 | AI Ethics, Safety & Guardrails | [Ethics & Safety Guide](advanced/03_ethics_safety_guardrails.ipynb) | Implement a responsible AI toolkit (bias detection, guardrails) |
+| 10-12 | AI Ethics, Safety & Guardrails | [Ethics & Safety Guide](advanced/03_safety_guardrails.ipynb) | Implement a responsible AI toolkit (bias detection, guardrails) |
 | 13-15 | GraphRAG & Knowledge Graphs | [GraphRAG Guide](advanced/05_graphrag.ipynb) | Knowledge graph RAG |
 | 16-18 | Custom LLM Evaluation | [Advanced Evals](advanced/06_advanced_evals.ipynb) | Custom eval framework |
-| 19-21 | AI Product Case Studies | [Case Studies](advanced/07_case_studies.md) | Analyze + present |
+| 19-21 | AI Product Case Studies | Case Studies (find and analyze 3 public post-mortems) | Analyze + present |
 
 **[→ Start Advanced Phase](advanced/)**
 

04_Foundations/programming/python_for_ds.md

@@ -402,4 +402,4 @@ Try these to solidify your skills:
 
 ---
 
-*Back to: [Foundations](../README.md) | [DS Track](../../01_Data_Scientist/) | [MLE Track](../../02_ML_Engineer/)*
+*Back to: [DS Track](../../01_Data_Scientist/) | [MLE Track](../../02_ML_Engineer/)*

04_Foundations/statistics/README.md

@@ -347,4 +347,4 @@ plt.show()
 
 ---
 
-*Back to: [Foundations](../README.md) | [DS Track](../../01_Data_Scientist/) | [Main README](../../README.md)*
+*Back to: [DS Track](../../01_Data_Scientist/) | [Main README](../../README.md)*

08_Career_Guide/networking_guide.md

@@ -343,4 +343,4 @@ Referrals are 4-6x more likely to convert to an offer than cold applications.
 
 ---
 
-*Back to: [Career Guide](../README.md) | [Portfolio Guide](./portfolio_guide.md) | [Main README](../../README.md)*
+*Back to: [Career Guide](../README.md) | [Portfolio Guide](./portfolio_guide.md) | [Main README](../README.md)*

08_Career_Guide/resume_guide.md

@@ -358,4 +358,4 @@ print(extract_keywords(jd))
 
 ---
 
-*Back to: [Career Guide](../README.md) | [Main README](../../README.md)*
+*Back to: [Career Guide](../README.md) | [Main README](../README.md)*