docs: [verified] move metric contracts under Measurement
Build and publish Eldorado documentation / build (pull_request) Successful in 41s
Build and publish Eldorado documentation / build (pull_request) Successful in 41s
This commit is contained in:
1 parent
b9c2047c61
commit
85852f0744
45 files changed
+1101
-433
No files matched your search
@@ -0,0 +1,36 @@
|
||||
---
|
||||
id: change-lead-time
|
||||
slug: /measurement/change-lead-time
|
||||
title: Change lead time
|
||||
description: Definition, collection evidence and limitations for change lead time.
|
||||
---
|
||||
|
||||
<div className="strategy-content">
|
||||
|
||||
**Target operating model — recommended contracts, not installed collection.** All owner and cadence entries below are proposals to confirm before the pilot, not assigned responsibilities or approved schedules.
|
||||
|
||||
**Unimplemented metric — no live telemetry.** This is a prospective contract, not an implemented calculation or collector.
|
||||
|
||||
{/* contract:start */}
|
||||
Arithmetic mean commit-to-first-successful-production-deployment duration; also publish median/p90 and sample count.
|
||||
|
||||
| Contract | Definition |
|
||||
| --- | --- |
|
||||
| Numerator | Sum of elapsed hours from committed_at to first successful production deployment for each service+commit |
|
||||
| Denominator | Count of eligible service+commit pairs with valid mappings |
|
||||
| Expression | N / D |
|
||||
| Aggregation | mean |
|
||||
| Unit | hours/change |
|
||||
| Eligible population | Changes first successfully deployed to a service in reporting window; rollout retries collapse to same logical deployment. |
|
||||
| Exclusions | Nonproduction, duplicates, no-op deployment with no new commits; missing mappings shown as coverage loss. |
|
||||
| Events and source | change.committed; deployment.completed; VCS immutable commit timestamps and release manifest |
|
||||
| Owner / cadence | Platform & IT / Weekly per service |
|
||||
| Missing evidence | Missing commit mapping or negative/skewed duration excluded from numeric sample, reported explicitly; no zero substitution. |
|
||||
| Gaming and limits | Timestamp rewriting and cherry-picking fast work; lock change mapping and show undeployed backlog age. Descriptive signal, not causal AI productivity attribution. Source completeness, task mix and sampling limit inference; report uncertainty. Not PR cycle time, effort saved, or a complete view of unfinished changes. p90 uses nearest-rank sorted sample. |
|
||||
{/* contract:end */}
|
||||
|
||||
Read the shared [collection and safeguards](./collection-and-safeguards.mdx) before collecting data; see the [synthetic example and limits](./synthetic-example.mdx).
|
||||
|
||||
Return to [Skills Measurement](./index.mdx).
|
||||
|
||||
</div>
|
||||
Reference in new issue
Block a user