Skip to content

Commit 30e95b7

Browse files
authored
Update _strategy.md
Signed-off-by: Jarkko Moilanen <jarkko@vimo.fi>
1 parent 9566612 commit 30e95b7

1 file changed

Lines changed: 6 additions & 16 deletions

File tree

source/includes/_strategy.md

Lines changed: 6 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ The `productStrategy` object captures the business intent behind a data product
44

55
By embedding business logic directly into the product specification, `productStrategy` ensures data products are not only technically sound but also strategically impactful.
66

7-
## Attributes
7+
## Attributes and options
88

99
> Example of catalog object usage:
1010
@@ -28,7 +28,7 @@ product:
2828
productKPIs:
2929
- id: kpi-detection-coverage
3030
name: Event Detection Coverage
31-
definition: % of reported incidents captured in real time
31+
description: % of reported incidents captured in real time
3232
unit: percentage
3333
target: 95
3434
direction: at_least
@@ -37,7 +37,7 @@ product:
3737

3838
- id: kpi-time-to-insight
3939
name: Average Time to Insight
40-
definition: Median time from event occurrence to product update
40+
description: Median time from event occurrence to product update
4141
unit: seconds
4242
target: 60
4343
direction: at_most
@@ -66,23 +66,13 @@ product:
6666
| **target** | number/string | – | Target value for the KPI. |
6767
| **direction** | enum | `increase`, `decrease`, `at_least`, `at_most`, `equals` | Desired direction of movement. |
6868
| **timeframe** | string | optional | When the target should be met. |
69+
| **frequency** | string | Measurement cadence (e.g., hourly, daily, monthly). |
70+
| **owner** | string | Responsible role/team (optional). |
71+
| **calculation** | string | Human‑readable formula (optional). |
6972
| **productKPIs** | array | optional | KPIs measured **at product level** that influence `contributesToKPI`. Useful for contribution analysis and governance checks. |
7073
| **relatedKPIs** | array | optional | Secondary/cross‑unit KPIs to monitor side‑effects and additional value (informational; not for prioritization). |
7174
| **strategicAlignment** | array | language‑tagged strings | Strategic initiatives, policies, or visions the product aligns with. |
7275

73-
### KPI object (for `productKPIs` / `relatedKPIs`)
74-
| Field | Type | Description |
75-
|---|---|---|
76-
| `id` | string | Identifier (recommended for cross‑product roll‑ups). |
77-
| `name` | string | KPI name. |
78-
| `definition` | string | What exactly is measured. |
79-
| `unit` | string | Unit of measurement. |
80-
| `target` | number/string | Target value. |
81-
| `direction` | enum | `increase`, `decrease`, `at_least`, `at_most`, `equals`. |
82-
| `timeframe` | string | Optional deadline for the target. |
83-
| `frequency` | string | Measurement cadence (e.g., hourly, daily, monthly). |
84-
| `owner` | string | Responsible role/team (optional). |
85-
| `calculation` | string | Human‑readable formula (optional). |
8676

8777

8878

0 commit comments

Comments
 (0)