From 7f79425b9079997a244dccaa8a576920817d74b9 Mon Sep 17 00:00:00 2001 From: Vijay Janapa Reddi Date: Wed, 16 Jul 2025 01:03:17 -0400 Subject: [PATCH] Simplify interactive elements to match usage paths style - clean text links only --- book/chapters/01-setup.md | 9 ++------- book/chapters/02-tensor.md | 9 ++------- book/chapters/03-activations.md | 9 ++------- book/chapters/04-layers.md | 9 ++------- book/chapters/05-networks.md | 9 ++------- book/chapters/06-cnn.md | 9 ++------- book/chapters/07-dataloader.md | 9 ++------- book/chapters/08-autograd.md | 9 ++------- book/chapters/09-optimizers.md | 9 ++------- book/chapters/10-training.md | 9 ++------- book/chapters/11-compression.md | 9 ++------- book/chapters/12-kernels.md | 9 ++------- book/chapters/13-benchmarking.md | 9 ++------- book/chapters/14-mlops.md | 9 ++------- book/convert_readmes.py | 11 +++-------- 15 files changed, 31 insertions(+), 106 deletions(-) diff --git a/book/chapters/01-setup.md b/book/chapters/01-setup.md index 437e31b3..9ff16859 100644 --- a/book/chapters/01-setup.md +++ b/book/chapters/01-setup.md @@ -186,14 +186,9 @@ The skills you learn here - the development workflow, testing patterns, and code ## 🚀 Ready to Build? -```{admonition} Choose Your Environment -:class: tip -**Quick Start:** [🚀 Launch Builder](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/01_setup/setup_dev.ipynb) *(Jump directly into implementation)* +**🚀 [Launch in Binder](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/01_setup/setup_dev.ipynb)** *(Live Jupyter environment)* -**Full Development:** [📓 Open Jupyter](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/01_setup/setup_dev.ipynb) *(Complete development environment)* - -**Cloud Environment:** [☁️ Open in Colab](https://colab.research.google.com/github/MLSysBook/TinyTorch/blob/main/modules/source/01_setup/setup_dev.ipynb) *(Google's notebook environment)* -``` +**📓 [Open in Colab](https://colab.research.google.com/github/MLSysBook/TinyTorch/blob/main/modules/source/01_setup/setup_dev.ipynb)** *(Google's cloud environment)* --- diff --git a/book/chapters/02-tensor.md b/book/chapters/02-tensor.md index 7f8430fb..68383741 100644 --- a/book/chapters/02-tensor.md +++ b/book/chapters/02-tensor.md @@ -233,14 +233,9 @@ Take your time, test thoroughly, and enjoy building something that really works! ## 🚀 Ready to Build? -```{admonition} Choose Your Environment -:class: tip -**Quick Start:** [🚀 Launch Builder](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/02_tensor/tensor_dev.ipynb) *(Jump directly into implementation)* +**🚀 [Launch in Binder](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/02_tensor/tensor_dev.ipynb)** *(Live Jupyter environment)* -**Full Development:** [📓 Open Jupyter](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/02_tensor/tensor_dev.ipynb) *(Complete development environment)* - -**Cloud Environment:** [☁️ Open in Colab](https://colab.research.google.com/github/MLSysBook/TinyTorch/blob/main/modules/source/02_tensor/tensor_dev.ipynb) *(Google's notebook environment)* -``` +**📓 [Open in Colab](https://colab.research.google.com/github/MLSysBook/TinyTorch/blob/main/modules/source/02_tensor/tensor_dev.ipynb)** *(Google's cloud environment)* --- diff --git a/book/chapters/03-activations.md b/book/chapters/03-activations.md index 7dafde13..b2fd8754 100644 --- a/book/chapters/03-activations.md +++ b/book/chapters/03-activations.md @@ -277,14 +277,9 @@ You've mastered this module when: ## 🚀 Ready to Build? -```{admonition} Choose Your Environment -:class: tip -**Quick Start:** [🚀 Launch Builder](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/03_activations/activations_dev.ipynb) *(Jump directly into implementation)* +**🚀 [Launch in Binder](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/03_activations/activations_dev.ipynb)** *(Live Jupyter environment)* -**Full Development:** [📓 Open Jupyter](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/03_activations/activations_dev.ipynb) *(Complete development environment)* - -**Cloud Environment:** [☁️ Open in Colab](https://colab.research.google.com/github/MLSysBook/TinyTorch/blob/main/modules/source/03_activations/activations_dev.ipynb) *(Google's notebook environment)* -``` +**📓 [Open in Colab](https://colab.research.google.com/github/MLSysBook/TinyTorch/blob/main/modules/source/03_activations/activations_dev.ipynb)** *(Google's cloud environment)* --- diff --git a/book/chapters/04-layers.md b/book/chapters/04-layers.md index 37a13c7a..1d15f63d 100644 --- a/book/chapters/04-layers.md +++ b/book/chapters/04-layers.md @@ -237,14 +237,9 @@ After completing this module, you're ready for: ## 🚀 Ready to Build? -```{admonition} Choose Your Environment -:class: tip -**Quick Start:** [🚀 Launch Builder](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/04_layers/layers_dev.ipynb) *(Jump directly into implementation)* +**🚀 [Launch in Binder](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/04_layers/layers_dev.ipynb)** *(Live Jupyter environment)* -**Full Development:** [📓 Open Jupyter](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/04_layers/layers_dev.ipynb) *(Complete development environment)* - -**Cloud Environment:** [☁️ Open in Colab](https://colab.research.google.com/github/MLSysBook/TinyTorch/blob/main/modules/source/04_layers/layers_dev.ipynb) *(Google's notebook environment)* -``` +**📓 [Open in Colab](https://colab.research.google.com/github/MLSysBook/TinyTorch/blob/main/modules/source/04_layers/layers_dev.ipynb)** *(Google's cloud environment)* --- diff --git a/book/chapters/05-networks.md b/book/chapters/05-networks.md index f292624f..a4d5b70e 100644 --- a/book/chapters/05-networks.md +++ b/book/chapters/05-networks.md @@ -301,14 +301,9 @@ Input → Dense(784,128) → ReLU → Dense(128,64) → ReLU → Dense(64,10) ## 🚀 Ready to Build? -```{admonition} Choose Your Environment -:class: tip -**Quick Start:** [🚀 Launch Builder](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/05_networks/networks_dev.ipynb) *(Jump directly into implementation)* +**🚀 [Launch in Binder](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/05_networks/networks_dev.ipynb)** *(Live Jupyter environment)* -**Full Development:** [📓 Open Jupyter](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/05_networks/networks_dev.ipynb) *(Complete development environment)* - -**Cloud Environment:** [☁️ Open in Colab](https://colab.research.google.com/github/MLSysBook/TinyTorch/blob/main/modules/source/05_networks/networks_dev.ipynb) *(Google's notebook environment)* -``` +**📓 [Open in Colab](https://colab.research.google.com/github/MLSysBook/TinyTorch/blob/main/modules/source/05_networks/networks_dev.ipynb)** *(Google's cloud environment)* --- diff --git a/book/chapters/06-cnn.md b/book/chapters/06-cnn.md index 8d5eb2cd..55adb19f 100644 --- a/book/chapters/06-cnn.md +++ b/book/chapters/06-cnn.md @@ -95,14 +95,9 @@ python -m pytest tests/test_cnn.py -v ## 🚀 Ready to Build? -```{admonition} Choose Your Environment -:class: tip -**Quick Start:** [🚀 Launch Builder](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/06_cnn/cnn_dev.ipynb) *(Jump directly into implementation)* +**🚀 [Launch in Binder](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/06_cnn/cnn_dev.ipynb)** *(Live Jupyter environment)* -**Full Development:** [📓 Open Jupyter](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/06_cnn/cnn_dev.ipynb) *(Complete development environment)* - -**Cloud Environment:** [☁️ Open in Colab](https://colab.research.google.com/github/MLSysBook/TinyTorch/blob/main/modules/source/06_cnn/cnn_dev.ipynb) *(Google's notebook environment)* -``` +**📓 [Open in Colab](https://colab.research.google.com/github/MLSysBook/TinyTorch/blob/main/modules/source/06_cnn/cnn_dev.ipynb)** *(Google's cloud environment)* --- diff --git a/book/chapters/07-dataloader.md b/book/chapters/07-dataloader.md index 3e9032c0..35714937 100644 --- a/book/chapters/07-dataloader.md +++ b/book/chapters/07-dataloader.md @@ -339,14 +339,9 @@ Focus on clean interfaces, efficient implementation, and systems thinking! 🔥 ## 🚀 Ready to Build? -```{admonition} Choose Your Environment -:class: tip -**Quick Start:** [🚀 Launch Builder](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/07_dataloader/dataloader_dev.ipynb) *(Jump directly into implementation)* +**🚀 [Launch in Binder](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/07_dataloader/dataloader_dev.ipynb)** *(Live Jupyter environment)* -**Full Development:** [📓 Open Jupyter](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/07_dataloader/dataloader_dev.ipynb) *(Complete development environment)* - -**Cloud Environment:** [☁️ Open in Colab](https://colab.research.google.com/github/MLSysBook/TinyTorch/blob/main/modules/source/07_dataloader/dataloader_dev.ipynb) *(Google's notebook environment)* -``` +**📓 [Open in Colab](https://colab.research.google.com/github/MLSysBook/TinyTorch/blob/main/modules/source/07_dataloader/dataloader_dev.ipynb)** *(Google's cloud environment)* --- diff --git a/book/chapters/08-autograd.md b/book/chapters/08-autograd.md index 684298a9..33875771 100644 --- a/book/chapters/08-autograd.md +++ b/book/chapters/08-autograd.md @@ -317,14 +317,9 @@ This module transforms TinyTorch from a static computation library into a dynami ## 🚀 Ready to Build? -```{admonition} Choose Your Environment -:class: tip -**Quick Start:** [🚀 Launch Builder](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/08_autograd/autograd_dev.ipynb) *(Jump directly into implementation)* +**🚀 [Launch in Binder](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/08_autograd/autograd_dev.ipynb)** *(Live Jupyter environment)* -**Full Development:** [📓 Open Jupyter](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/08_autograd/autograd_dev.ipynb) *(Complete development environment)* - -**Cloud Environment:** [☁️ Open in Colab](https://colab.research.google.com/github/MLSysBook/TinyTorch/blob/main/modules/source/08_autograd/autograd_dev.ipynb) *(Google's notebook environment)* -``` +**📓 [Open in Colab](https://colab.research.google.com/github/MLSysBook/TinyTorch/blob/main/modules/source/08_autograd/autograd_dev.ipynb)** *(Google's cloud environment)* --- diff --git a/book/chapters/09-optimizers.md b/book/chapters/09-optimizers.md index 225c5579..d40e9fd5 100644 --- a/book/chapters/09-optimizers.md +++ b/book/chapters/09-optimizers.md @@ -232,14 +232,9 @@ Your optimizers will be the engine that transforms gradients into intelligence! ## 🚀 Ready to Build? -```{admonition} Choose Your Environment -:class: tip -**Quick Start:** [🚀 Launch Builder](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/09_optimizers/optimizers_dev.ipynb) *(Jump directly into implementation)* +**🚀 [Launch in Binder](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/09_optimizers/optimizers_dev.ipynb)** *(Live Jupyter environment)* -**Full Development:** [📓 Open Jupyter](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/09_optimizers/optimizers_dev.ipynb) *(Complete development environment)* - -**Cloud Environment:** [☁️ Open in Colab](https://colab.research.google.com/github/MLSysBook/TinyTorch/blob/main/modules/source/09_optimizers/optimizers_dev.ipynb) *(Google's notebook environment)* -``` +**📓 [Open in Colab](https://colab.research.google.com/github/MLSysBook/TinyTorch/blob/main/modules/source/09_optimizers/optimizers_dev.ipynb)** *(Google's cloud environment)* --- diff --git a/book/chapters/10-training.md b/book/chapters/10-training.md index aa806402..7b104fdb 100644 --- a/book/chapters/10-training.md +++ b/book/chapters/10-training.md @@ -305,14 +305,9 @@ history = trainer.fit(housing_loader, epochs=100) ## 🚀 Ready to Build? -```{admonition} Choose Your Environment -:class: tip -**Quick Start:** [🚀 Launch Builder](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/10_training/training_dev.ipynb) *(Jump directly into implementation)* +**🚀 [Launch in Binder](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/10_training/training_dev.ipynb)** *(Live Jupyter environment)* -**Full Development:** [📓 Open Jupyter](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/10_training/training_dev.ipynb) *(Complete development environment)* - -**Cloud Environment:** [☁️ Open in Colab](https://colab.research.google.com/github/MLSysBook/TinyTorch/blob/main/modules/source/10_training/training_dev.ipynb) *(Google's notebook environment)* -``` +**📓 [Open in Colab](https://colab.research.google.com/github/MLSysBook/TinyTorch/blob/main/modules/source/10_training/training_dev.ipynb)** *(Google's cloud environment)* --- diff --git a/book/chapters/11-compression.md b/book/chapters/11-compression.md index c3e13e5d..737f0d3e 100644 --- a/book/chapters/11-compression.md +++ b/book/chapters/11-compression.md @@ -203,14 +203,9 @@ This module bridges the gap between research-quality models and production-ready ## 🚀 Ready to Build? -```{admonition} Choose Your Environment -:class: tip -**Quick Start:** [🚀 Launch Builder](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/11_compression/compression_dev.ipynb) *(Jump directly into implementation)* +**🚀 [Launch in Binder](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/11_compression/compression_dev.ipynb)** *(Live Jupyter environment)* -**Full Development:** [📓 Open Jupyter](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/11_compression/compression_dev.ipynb) *(Complete development environment)* - -**Cloud Environment:** [☁️ Open in Colab](https://colab.research.google.com/github/MLSysBook/TinyTorch/blob/main/modules/source/11_compression/compression_dev.ipynb) *(Google's notebook environment)* -``` +**📓 [Open in Colab](https://colab.research.google.com/github/MLSysBook/TinyTorch/blob/main/modules/source/11_compression/compression_dev.ipynb)** *(Google's cloud environment)* --- diff --git a/book/chapters/12-kernels.md b/book/chapters/12-kernels.md index 68501345..d7a11595 100644 --- a/book/chapters/12-kernels.md +++ b/book/chapters/12-kernels.md @@ -173,14 +173,9 @@ By the end, you'll think like a **performance engineer**, not just a machine lea ## 🚀 Ready to Build? -```{admonition} Choose Your Environment -:class: tip -**Quick Start:** [🚀 Launch Builder](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/12_kernels/kernels_dev.ipynb) *(Jump directly into implementation)* +**🚀 [Launch in Binder](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/12_kernels/kernels_dev.ipynb)** *(Live Jupyter environment)* -**Full Development:** [📓 Open Jupyter](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/12_kernels/kernels_dev.ipynb) *(Complete development environment)* - -**Cloud Environment:** [☁️ Open in Colab](https://colab.research.google.com/github/MLSysBook/TinyTorch/blob/main/modules/source/12_kernels/kernels_dev.ipynb) *(Google's notebook environment)* -``` +**📓 [Open in Colab](https://colab.research.google.com/github/MLSysBook/TinyTorch/blob/main/modules/source/12_kernels/kernels_dev.ipynb)** *(Google's cloud environment)* --- diff --git a/book/chapters/13-benchmarking.md b/book/chapters/13-benchmarking.md index 33e081e4..1f05b6a5 100644 --- a/book/chapters/13-benchmarking.md +++ b/book/chapters/13-benchmarking.md @@ -182,14 +182,9 @@ By the end of this module, you should be able to: ## 🚀 Ready to Build? -```{admonition} Choose Your Environment -:class: tip -**Quick Start:** [🚀 Launch Builder](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/13_benchmarking/benchmarking_dev.ipynb) *(Jump directly into implementation)* +**🚀 [Launch in Binder](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/13_benchmarking/benchmarking_dev.ipynb)** *(Live Jupyter environment)* -**Full Development:** [📓 Open Jupyter](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/13_benchmarking/benchmarking_dev.ipynb) *(Complete development environment)* - -**Cloud Environment:** [☁️ Open in Colab](https://colab.research.google.com/github/MLSysBook/TinyTorch/blob/main/modules/source/13_benchmarking/benchmarking_dev.ipynb) *(Google's notebook environment)* -``` +**📓 [Open in Colab](https://colab.research.google.com/github/MLSysBook/TinyTorch/blob/main/modules/source/13_benchmarking/benchmarking_dev.ipynb)** *(Google's cloud environment)* --- diff --git a/book/chapters/14-mlops.md b/book/chapters/14-mlops.md index af814d9c..7dbbb5fd 100644 --- a/book/chapters/14-mlops.md +++ b/book/chapters/14-mlops.md @@ -352,14 +352,9 @@ This module represents the culmination of your TinyTorch journey - from basic te ## 🚀 Ready to Build? -```{admonition} Choose Your Environment -:class: tip -**Quick Start:** [🚀 Launch Builder](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/14_mlops/mlops_dev.ipynb) *(Jump directly into implementation)* +**🚀 [Launch in Binder](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/14_mlops/mlops_dev.ipynb)** *(Live Jupyter environment)* -**Full Development:** [📓 Open Jupyter](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/14_mlops/mlops_dev.ipynb) *(Complete development environment)* - -**Cloud Environment:** [☁️ Open in Colab](https://colab.research.google.com/github/MLSysBook/TinyTorch/blob/main/modules/source/14_mlops/mlops_dev.ipynb) *(Google's notebook environment)* -``` +**📓 [Open in Colab](https://colab.research.google.com/github/MLSysBook/TinyTorch/blob/main/modules/source/14_mlops/mlops_dev.ipynb)** *(Google's cloud environment)* --- diff --git a/book/convert_readmes.py b/book/convert_readmes.py index ddb4bf8d..fdd17483 100644 --- a/book/convert_readmes.py +++ b/book/convert_readmes.py @@ -83,20 +83,15 @@ def enhance_content_for_web(content: str, module_name: str, module_num: int) -> """ - # Add interactive elements and navigation links at the end + # Add simple interactive links and navigation at the end interactive_elements = f""" --- ## 🚀 Ready to Build? -```{{admonition}} Choose Your Environment -:class: tip -**Quick Start:** [🚀 Launch Builder](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/{module_name}/{module_name.split('_', 1)[1]}_dev.ipynb) *(Jump directly into implementation)* +**🚀 [Launch in Binder](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/{module_name}/{module_name.split('_', 1)[1]}_dev.ipynb)** *(Live Jupyter environment)* -**Full Development:** [📓 Open Jupyter](https://mybinder.org/v2/gh/MLSysBook/TinyTorch/main?filepath=modules/source/{module_name}/{module_name.split('_', 1)[1]}_dev.ipynb) *(Complete development environment)* - -**Cloud Environment:** [☁️ Open in Colab](https://colab.research.google.com/github/MLSysBook/TinyTorch/blob/main/modules/source/{module_name}/{module_name.split('_', 1)[1]}_dev.ipynb) *(Google's notebook environment)* -``` +**📓 [Open in Colab](https://colab.research.google.com/github/MLSysBook/TinyTorch/blob/main/modules/source/{module_name}/{module_name.split('_', 1)[1]}_dev.ipynb)** *(Google's cloud environment)* ---