Skip to content

Commit 4e95856

Browse files
authored
Standardize phase headings in README
Updated phase headings in the README to use colons instead of dashes for consistency.
1 parent 9bf0ab2 commit 4e95856

1 file changed

Lines changed: 16 additions & 21 deletions

File tree

README.md

Lines changed: 16 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -28,14 +28,14 @@ Last updated: 2026-04-08
2828

2929
- [What is MLOps?](#what-is-mlops)
3030
- [MLOps Maturity Levels](#mlops-maturity-levels)
31-
- [Phase 1 Problem Definition & Business Understanding](#phase-1--problem-definition--business-understanding)
32-
- [Phase 2 Data Management & Preparation](#phase-2--data-management--preparation)
33-
- [Phase 3 Model Development & Experimentation](#phase-3--model-development--experimentation)
34-
- [Phase 4 Model Training at Scale](#phase-4--model-training-at-scale)
35-
- [Phase 5 Model Evaluation & Validation](#phase-5--model-evaluation--validation)
36-
- [Phase 6 Model Deployment & Serving](#phase-6--model-deployment--serving)
37-
- [Phase 7 Monitoring & Observability](#phase-7--monitoring--observability)
38-
- [Phase 8 Retraining & Continuous Improvement](#phase-8--retraining--continuous-improvement)
31+
- [Phase 1: Problem Definition & Business Understanding](#phase-1--problem-definition--business-understanding)
32+
- [Phase 2: Data Management & Preparation](#phase-2--data-management--preparation)
33+
- [Phase 3: Model Development & Experimentation](#phase-3--model-development--experimentation)
34+
- [Phase 4: Model Training at Scale](#phase-4--model-training-at-scale)
35+
- [Phase 5: Model Evaluation & Validation](#phase-5--model-evaluation--validation)
36+
- [Phase 6: Model Deployment & Serving](#phase-6--model-deployment--serving)
37+
- [Phase 7: Monitoring & Observability](#phase-7--monitoring--observability)
38+
- [Phase 8: Retraining & Continuous Improvement](#phase-8--retraining--continuous-improvement)
3939
- [Cross-Cutting Concerns](#cross-cutting-concerns)
4040
- [Infrastructure as Code](#infrastructure-as-code)
4141

@@ -77,7 +77,7 @@ The core pillars of MLOps on Azure are:
7777
> [!TIP]
7878
> Start by assessing your current maturity level honestly. Most organizations land at Level 0 or 1. Focus on progressing one level at a time rather than trying to implement everything at once.
7979
80-
## Phase 1 Problem Definition & Business Understanding
80+
## Phase 1: Problem Definition & Business Understanding
8181

8282
> Before writing a single line of code, align on what success looks like. This phase is often underestimated but is the single biggest determinant of whether an ML project delivers value.
8383
@@ -98,7 +98,7 @@ The core pillars of MLOps on Azure are:
9898
| **Responsible AI documentation** | Establish a **Model Card** or **AI Use Case Description** early — this feeds directly into Responsible AI documentation later. |
9999
| **Service Level Agreements** | Define **SLAs** for model latency, availability, and retraining frequency before any architecture decisions are made. |
100100

101-
## Phase 2 Data Management & Preparation
101+
## Phase 2: Data Management & Preparation
102102

103103
> Data is the foundation of every ML system. Azure provides a rich ecosystem for storing, versioning, and transforming data at scale.
104104
@@ -128,7 +128,7 @@ The core pillars of MLOps on Azure are:
128128
| **Secure storage** | Store sensitive data in **Azure Data Lake Storage Gen2** with hierarchical namespace enabled, access controlled via Azure RBAC and ACLs — never embed credentials in code. |
129129
| **Data protection** | Enable **soft delete** and **versioning** on Azure Blob/ADLS to protect against accidental deletion. |
130130

131-
## Phase 3 Model Development & Experimentation
131+
## Phase 3: Model Development & Experimentation
132132

133133
> This phase is the most iterative. The goal is to rapidly explore hypotheses, track experiments, and identify the best modeling approach.
134134
@@ -158,7 +158,7 @@ The core pillars of MLOps on Azure are:
158158
| **Code separation** | Separate **research code** (notebooks) from **production code** (Python modules). Notebooks are great for exploration but not for pipelines. |
159159
| **Environment management** | Register **compute environments** as Azure ML Environments so the same Docker image is used in local dev, CI, and production training. |
160160

161-
## Phase 4 Model Training at Scale
161+
## Phase 4: Model Training at Scale
162162

163163
> Once you have a promising approach, move from interactive notebooks to **automated, parameterized training pipelines** that can run reliably on cloud compute.
164164
@@ -189,8 +189,7 @@ The core pillars of MLOps on Azure are:
189189
| **Named outputs** | Store all training outputs (model artifacts, metrics, logs) as named outputs in the pipeline for automatic tracking and lineage. |
190190
| **Pinned environments** | Pin the **Azure ML Environment** (Docker image + conda/pip dependencies) so training is fully reproducible months later. |
191191

192-
193-
## Phase 5 — Model Evaluation & Validation
192+
## Phase 5: Model Evaluation & Validation
194193

195194
> A model that performs well on a held-out test set is not automatically ready for production. Validation must go beyond aggregate metrics.
196195
@@ -222,8 +221,7 @@ The core pillars of MLOps on Azure are:
222221
| **Champion comparison** | Always compare the new model against the **currently deployed champion** on the same test dataset, not just an absolute threshold. |
223222
| **Model tagging & lineage** | Tag every registered model with training data version, pipeline run ID, Git commit SHA, and key metrics to ensure full traceability. |
224223

225-
226-
## Phase 6 — Model Deployment & Serving
224+
## Phase 6: Model Deployment & Serving
227225

228226
> Getting a validated model to production in a reliable, secure, and observable way.
229227
@@ -253,8 +251,7 @@ The core pillars of MLOps on Azure are:
253251
| **Smoke & integration tests** | Run automated tests against the staging deployment in the CD pipeline before promoting to production. |
254252
| **Registry-based deployments** | Reference model artifacts from the **Azure ML Model Registry** by name and version — never copy files manually. |
255253

256-
257-
## Phase 7 — Monitoring & Observability
254+
## Phase 7: Monitoring & Observability
258255

259256
> A deployed model is not "done." Its performance degrades over time as the real world changes. Monitoring is what keeps production models healthy.
260257
@@ -277,8 +274,7 @@ The core pillars of MLOps on Azure are:
277274
| **Baseline dataset** | Store a baseline dataset (training data or representative sample) at deployment time — Azure ML uses this as the reference distribution for drift calculations. |
278275
| **Ground truth collection** | Collect and store ground truth labels wherever possible to compute actual model performance metrics in production. |
279276

280-
281-
## Phase 8 — Retraining & Continuous Improvement
277+
## Phase 8: Retraining & Continuous Improvement
282278

283279
> Models must evolve with the data. The goal of this phase is a closed-loop system where monitoring signals feed back into the training pipeline automatically or with minimal human intervention.
284280
@@ -350,7 +346,6 @@ PR / Push to main
350346
> [!NOTE]
351347
> Use **GitHub Actions** (preferred for open source / GitHub-native projects) or **Azure DevOps Pipelines** for CI/CD. Both have first-class Azure ML integration via the `azure/ml` GitHub Actions or `AzureML` DevOps tasks.
352348
353-
354349
## Infrastructure as Code
355350

356351
> All Azure ML infrastructure in this repository is provisioned via **Terraform**. See the [terraform-infrastructure/README.md](terraform-infrastructure/README.md) for full deployment instructions.

0 commit comments

Comments
 (0)