Skip to content

Commit 04ea4b6

Browse files
MariusStorhaugMariusStorhaug
authored
Merge branch 'main' into docs/colocate-style-guides
2 parents 2af5697 + 5cc80d4 commit 04ea4b6

8 files changed

Lines changed: 411 additions & 9 deletions

File tree

‎.github/linters/.codespellrc‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
11
[codespell]
22
skip = ./.github/linters
3-
ignore-words-list = afterall
3+
ignore-words-list = afterall,skelton,erformance

‎.github/workflows/Docs.yml‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ jobs:
3535
statuses: write # super-linter: report status checks
3636
steps:
3737
- name: Checkout repository
38-
uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
38+
uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
3939
with:
4040
fetch-depth: 0
4141
persist-credentials: false
@@ -59,7 +59,7 @@ jobs:
5959
contents: read
6060
steps:
6161
- name: Checkout repository
62-
uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
62+
uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
6363
with:
6464
persist-credentials: false
6565

@@ -72,7 +72,7 @@ jobs:
7272
Script: .github/scripts/main.ps1
7373

7474
- name: Set up Python
75-
uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
75+
uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
7676
with:
7777
python-version: 3.x
7878

‎src/docs/Ways-of-Working/Commit-Conventions.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ Commit messages serve two audiences: the engineer reading `git log` six months f
88
2. **No conventional-commit prefixes.** No `fix:`, `feat:`, `docs:`, `chore:`, `refactor:`, etc. The change type is captured at the PR level — repeating it on every commit adds noise without information.
99
3. **No generic messages.** `Update for PR`, `WIP`, `fixes`, `more changes` — all forbidden. They erase traceability.
1010
4. **One logical change per commit.** Micro-iterative discipline. If a change touches three unrelated concerns, that's three commits.
11-
5. **Reference issues by number when natural** — but don't force it. `Fixes #N` belongs in the PR description, not every commit message.
11+
5. **Keep issue and pull request references out of commit messages.** Cross-references to issues and pull requests belong in the PR description and in issues — not in commit history. The pull request links the work to its issue (via a closing keyword such as `Fixes #123`); commits describe the change itself.
1212

1313
## Examples
1414

‎src/docs/Ways-of-Working/Issue-Format.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,7 @@ Every issue in the PSModule organization follows the same structure. The format
1313
- **Comments record change history only.** Each description update is accompanied by a comment summarizing what changed and why.
1414
- **Tone is impersonal.** No first-person ("I", "my") or second-person ("you", "your") language. Neutral references like "the user", "the developer", or passive constructions.
1515
- **External references are hyperlinks.** Every mention of an API, RFC, library, doc, or tool is a clickable `[text](url)` link. No bare URLs.
16+
- **Issue and PR references are scoped to their target.** Use the `#123` shorthand for an issue or pull request in the same repository, and the fully qualified `Owner/Repo#123` form for one in another repository so the link resolves to the right place. Outside GitHub — Jira, Confluence, Slack, or any surface without GitHub autolinking — use the full URL (`https://github.com/Owner/Repo/issues/123`).
1617
- **No duplicates.** Existing issues are searched before creating or restructuring. Duplicates are consolidated or cross-linked.
1718

1819
## Title

‎src/docs/Ways-of-Working/PR-Format.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -103,13 +103,13 @@ Omit the section entirely if there's nothing noteworthy.
103103

104104
### 4. Related issues
105105

106-
A collapsible `<details>` block at the very end of the description containing issue links. Always use fully qualified references (`Owner/Repo#N`) so links work across repositories.
106+
A collapsible `<details>` block at the very end of the description containing issue links. Use the `#123` shorthand for issues in the same repository and the fully qualified `Owner/Repo#123` form for issues in another repository so links resolve to the right place. When a reference appears outside GitHub (release announcements, Jira, Slack, external docs), use the full URL (`https://github.com/Owner/Repo/issues/123`).
107107

108108
```markdown
109109
<details>
110110
<summary>Related issues</summary>
111111

112-
- Fixes PSModule/GitHub#123
112+
- Fixes #123
113113
- PSModule/Process-PSModule#124
114114

115115
</details>
@@ -155,8 +155,8 @@ Commands that query a specific repository, enterprise, or release by name now re
155155
<details>
156156
<summary>Related issues</summary>
157157

158-
- Fixes PSModule/GitHub#218
159-
- PSModule/GitHub#219
158+
- Fixes #218
159+
- #219
160160

161161
</details>
162162
````

‎src/docs/Ways-of-Working/continuous-x-and-continuous-ai.md‎

Lines changed: 156 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,156 @@
1+
# Continuous X Practices, Continuous AI, and the Microsoft DevOps Dojo
2+
3+
## 1. The "Continuous X" Practices
4+
5+
### Microsoft DevOps Dojo's eight pillars (White Belt)
6+
7+
The cleanest authoritative taxonomy. From [DevOps Dojo White Belt Foundation](https://learn.microsoft.com/en-us/training/paths/devops-dojo-white-belt-foundation/):
8+
9+
| # | Practice | What it covers |
10+
| --- | ---------- | ---------------- |
11+
| 1 | Continuous Planning | Lean product, hypothesis-driven dev, backlog management, OKRs |
12+
| 2 | Continuous Integration | Trunk-based dev, automated build & test on every commit |
13+
| 3 | Continuous Delivery | Every commit potentially releasable; automated pipeline to prod |
14+
| 4 | Continuous Quality | Test pyramid, shift-left testing, code review, static analysis |
15+
| 5 | Continuous Security | Shift-left security, SAST/DAST/SCA, secrets, supply chain |
16+
| 6 | Continuous Operations | SRE, observability, SLOs, incident response, on-call |
17+
| 7 | Continuous Collaboration | ChatOps, docs-as-code, transparent comms, shared ownership |
18+
| 8 | Continuous Improvement | Kaizen, retros, blameless postmortems, value-stream mapping |
19+
20+
### Full inventory with provenance
21+
22+
| Practice | Origin / canonical source |
23+
| ---------- | -------------------------- |
24+
| **Continuous Integration** | Coined in Grady Booch's 1991 method; popularised by XP and [Martin Fowler's 2006 article](https://martinfowler.com/articles/continuousIntegration.html). |
25+
| **Continuous Delivery** | Jez Humble & David Farley, [*Continuous Delivery*](https://continuousdelivery.com/), 2010. |
26+
| **Continuous Deployment** | Every passing build deploys to prod with no human gate (vs. CD which only makes it *deployable*). |
27+
| **Continuous Testing** | Test throughout the pipeline plus in production (synthetic, canary analysis). |
28+
| **Continuous Verification** | Netflix's term for chaos-engineering-style continuous resilience validation. Rosenthal & Jones, [*Chaos Engineering*](https://www.oreilly.com/library/view/chaos-engineering/9781492043850/), O'Reilly. |
29+
| **Continuous Monitoring → Continuous Observability** | Shift from dashboards of knowns to ad-hoc querying of unknowns. [Honeycomb's Observability Manifesto](https://www.honeycomb.io/blog/observability-a-manifesto). |
30+
| **Continuous Feedback** | Right-to-left flow from prod → dev. DevOps Second Way (*Phoenix Project*). |
31+
| **Continuous Improvement** | Toyota *kaizen*; Deming PDCA cycle. |
32+
| **Continuous Learning** | DevOps Third Way (Kim, *Phoenix Project*). |
33+
| **Continuous Security / DevSecOps** | OWASP; [DoD Enterprise DevSecOps Reference Design](https://dodcio.defense.gov/Portals/0/Documents/DoD%20Enterprise%20DevSecOps%20Reference%20Design%20v1.0_Public%20Release.pdf). |
34+
| **Continuous Compliance** | Compliance-as-code: Chef InSpec, OPA, AWS Config. |
35+
| **Continuous Configuration Automation (CCA)** | Gartner term covering Ansible/Puppet/Chef/Salt. |
36+
| **Continuous Inspection** | SonarSource's term for always-on code-quality scanning. [docs.sonarsource.com](https://docs.sonarsource.com/). |
37+
| **Continuous Profiling** | Always-on production profiling. Pyroscope/Grafana, Polar Signals, Google-Wide Profiling paper (2010). |
38+
| **Continuous Documentation / docs-as-code** | Write the Docs community; treat docs like code. |
39+
| **Continuous Experimentation** | A/B testing, hypothesis-driven dev. Kohavi et al., [*Trustworthy Online Controlled Experiments*](https://experimentguide.com/), 2020. |
40+
| **Continuous Discovery** | Teresa Torres, [*Continuous Discovery Habits*](https://www.producttalk.org/continuous-discovery-habits/), 2021. |
41+
| **Continuous Architecture** | Erder & Pureur, *Continuous Architecture in Practice*, 2021. |
42+
| **Continuous Refactoring** | XP practice; Fowler's [*Refactoring*](https://martinfowler.com/books/refactoring.html). |
43+
| **Continuous Reliability** | Vendor-popularised (Catchpoint, Gremlin); convergence of SRE + chaos + observability. |
44+
| **Continuous Code Review** | Modern PR workflows + always-on reviewers. |
45+
| **Continuous Training (CT)** in MLOps | Google's [MLOps Levels 1–2](https://cloud.google.com/architecture/mlops-continuous-delivery-and-automation-pipelines-in-machine-learning) — automatic retraining on fresh data. |
46+
47+
---
48+
49+
## 2. Continuous AI
50+
51+
**Canonical source:** [GitHub Next — Continuous AI](https://githubnext.com/projects/continuous-ai/), published June 2025 by Eddie Aftandilian, Peli de Halleux, Russell Horton, Don Syme.
52+
53+
### Definition (verbatim)
54+
> "All uses of automated AI to support software collaboration on any platform."
55+
56+
Positioned explicitly as the AI-era counterpart to CI/CD: *"Just as CI/CD transformed software development by automating integration and deployment, Continuous AI covers the ways in which AI can be used to automate and enhance collaboration workflows."*
57+
58+
GitHub explicitly does **not** claim ownership of the term — it's a label for the industry, not a product.
59+
60+
### Seven characteristics (GitHub Next's taxonomy)
61+
Continuous AI tasks are: **automatable, repetitive, collaborative, integrated, auditable, event-triggered**, and have **many variants**.
62+
63+
### GitHub Next's example workflows
64+
- **Continuous Documentation** — docs in sync with code automatically
65+
- **Continuous Code Improvement** — comments, tests, small refactors
66+
- **Continuous Triage** — label/summarise/respond to issues in natural language
67+
- **Continuous Summarization** — rolling summaries of project activity
68+
- **Continuous Fault Analysis** — auto-explain failed CI runs
69+
- **Continuous Quality** — LLM-driven quality analysis
70+
- **Continuous Team Motivation** — PRs into poetry/zines/podcasts (the social layer)
71+
- **Continuous Accessibility** — auto-check & improve a11y
72+
73+
### Continuous AI vs. its cousins
74+
75+
| Term | What it is |
76+
| ------ | ----------- |
77+
| **Continuous AI** | AI participating *in* the SDLC continuously (review, docs, triage, fault analysis). The AI is the actor. |
78+
| **MLOps** | CI/CD/CT *for* ML models — training, evaluation, deployment, monitoring. The model is the product. |
79+
| **LLMOps** | MLOps specialised for LLM apps: prompt versioning, evals, retrieval, guardrails, cost/latency monitoring. |
80+
| **AIOps** | AI/ML applied to IT operations — anomaly detection, alert correlation, RCA. Gartner term, ~2017. |
81+
82+
### How Continuous AI augments each Continuous X practice
83+
84+
| Traditional practice | Continuous-AI augmentation | Example tools (2025) |
85+
| --------------------- | --------------------------- | ---------------------- |
86+
| Continuous Integration | AI summarises broken builds; suggests fixes | GitHub Copilot Workspace, Sweep |
87+
| Continuous Delivery | Agents drive multi-step deploys; AI-authored release notes | GitHub Copilot agents, Devin |
88+
| Continuous Testing | Test generation, flaky-test detection, auto-repair | Diffblue, Qodo (CodiumAI), Meta TestGen-LLM |
89+
| Continuous Quality | LLM PR review beyond linters | CodeRabbit, Greptile, Graphite Diamond, Copilot review |
90+
| Continuous Security | LLM-aware SAST, auto-remediation PRs | Snyk DeepCode, Semgrep Assistant, Copilot Autofix |
91+
| Continuous Operations | "AI SRE" — autonomous triage, RCA, runbook execution | Resolve.ai, Cleric, PagerDuty AIOps, Rootly AI |
92+
| Continuous Documentation | Docs stay in sync with code | Mintlify, GitHub Next *Continuous Documentation* |
93+
| Continuous Code Review | Always-on AI reviewer | CodeRabbit, Greptile, Copilot review |
94+
| Continuous Refactoring | Background agents propose refactors | Cursor background agents, Sourcegraph Cody, Grit.io |
95+
| Continuous Triage | Issue labelling, dedup, summarisation | GitHub Models + Actions recipes, Linear AI |
96+
| Continuous Improvement | Auto-postmortems, retro summaries | incident.io, Rootly, Jeli (Atlassian) |
97+
| Continuous Discovery | LLM synthesis of user research | Dovetail AI, Maze AI |
98+
| Continuous Training (MLOps) | Pre-existed; now intersects with eval-driven LLM dev | Vertex AI, Databricks, Weights & Biases |
99+
100+
### What structurally changes
101+
102+
- **Evals are the new tests.** For AI features, regression suites are eval suites — graded by LLM judges or humans. Eval drift = test failure.
103+
- **Pipelines gain non-deterministic actors.** Every Continuous AI step needs auditability: which agent, which model version, which prompt, which tools, what did it touch.
104+
- **Cost and runaway risk.** Traditional CI steps have bounded cost; agentic steps can recurse. Need budgets, timeouts, concurrency caps.
105+
- **Prompt injection becomes a CI/CD threat.** Untrusted issue text, PR descriptions, error messages, third-party docs become attack surfaces when an agent reads them.
106+
- **Governance.** Expect "AI-generated change" to need provenance equivalent to a signed commit. SOC2/ISO27001/regulators catching up.
107+
108+
### Tooling stack referenced by GitHub Next
109+
- [GitHub Actions](https://github.com/features/actions)
110+
- [GitHub Models](https://github.com/features/models)
111+
- [GenAIScript (Microsoft)](https://microsoft.github.io/genaiscript/)
112+
- [Datasette `llm`](https://llm.datasette.io/)
113+
- [GitHub Agentic Workflows](https://githubnext.com/projects/agentic-workflows/) — sister project at GitHub Next
114+
- [The Agentics](https://github.com/githubnext/agentics/) — example workflows
115+
116+
---
117+
118+
## 3. Microsoft DevOps Dojo — Status
119+
120+
**Status:** alive but dormant. White Belt remains a real Microsoft Learn path; higher belts are blog posts; GitHub org quiet since late 2022.
121+
122+
### History
123+
Started ~2018–2019 inside Microsoft (catalysed by a 2019 conversation with German CIOs); grew into a cross-org community spanning Services, Customer Success, Digital Advisory, and product groups. Public face was largely **April Edwards** (Senior Cloud Advocate). Authoritative intro: [*Intro of DevOps Dojo*](https://devblogs.microsoft.com/devops/intro-of-devops-dojo/) on Azure DevOps Blog (July 2022).
124+
125+
### Belt curriculum
126+
- **White Belt** — standardised DevOps fundamentals — *only one with a formal Microsoft Learn path*
127+
- **Orange Belt** — scaled DevOps (enterprise/program/portfolio) — blog only
128+
- **Green Belts** — domain lenses (e.g. UX/Accessibility) — blog only
129+
- **Black Belt** — data-driven, intelligent DevOps for executives — never published
130+
131+
Four pillars: Culture & Mindset, Lean Product, Architecture, Technology.
132+
133+
### Where the content lives today
134+
135+
**Microsoft Learn — White Belt (six modules):**
136+
- [DevOps Dojo White Belt Foundation](https://learn.microsoft.com/en-us/training/paths/devops-dojo-white-belt-foundation/)
137+
138+
**Azure DevOps Blog (the deeper belts):**
139+
- [Intro of DevOps Dojo](https://devblogs.microsoft.com/devops/intro-of-devops-dojo/)
140+
- [People & Teams (Orange)](https://devblogs.microsoft.com/devops/devops-dojo-people-teams/)
141+
- [UX/Accessibility (Green)](https://devblogs.microsoft.com/devops/devops-dojo-ux-accessibility/)
142+
- [Culture and Mindset](https://devblogs.microsoft.com/devops/devops-dojo-culture-and-mindset/)
143+
- [Experiential Learning](https://devblogs.microsoft.com/devops/devops-dojo-experiential-learning/)
144+
- [Lean Product Part 1 / Part 2](https://devblogs.microsoft.com/devops/devops-dojo-lean-product-part-1/)
145+
146+
**DevOps Lab video series:** [learn.microsoft.com/shows/devops-lab](https://learn.microsoft.com/en-us/shows/devops-lab/)
147+
148+
**GitHub:** [github.com/microsoftdevopsdojo](https://github.com/microsoftdevopsdojo) — sparse, last meaningful activity Oct 2022.
149+
150+
### What to use today
151+
1. **Dojo White Belt** on Learn — for the Continuous X scaffolding
152+
2. **[Evolve your DevOps practices](https://learn.microsoft.com/en-us/training/paths/evolve-your-devops-practices/)** — practical follow-on
153+
3. **[ISE Engineering Fundamentals Playbook](https://microsoft.github.io/code-with-engineering-playbook/)** — Microsoft's public, actively-maintained engineering playbook. The de facto modern equivalent.
154+
4. **[AZ-400 Enterprise DevOps](https://learn.microsoft.com/en-us/credentials/certifications/devops-engineer/)** — certification track
155+
156+
The ISE Playbook is the more living artifact — updated regularly, public PRs welcome, covers similar ground without the belt theatre.

0 commit comments

Comments
 (0)