Skip to content

Commit f0ad9db

Browse files
committed
Update styling in List and Tables for service-catalog-metadata-schema-ownership-tracking article
1 parent af1fb8e commit f0ad9db

3 files changed

Lines changed: 130 additions & 76 deletions

File tree

‎src/components/Table/layouts/striped-rows.astro‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ const { content, classes, fullWidth = true }: Props = Astro.props
3434
const tableClass = `text-left${fullWidth ? ' w-full' : ''}`
3535
const captionClass = 'text-left px-5 py-3 text-content-offset'
3636
const headerClass = 'px-5 py-3 font-semibold'
37-
const theadClass = 'bg-primary text-primary-inverse'
37+
const theadClass = 'bg-note-offset text-primary-inverse'
3838
const tbodyClass = ''
3939
const tfootClass = ''
4040
---

‎src/content/articles/service-catalog-metadata-schema-ownership-tracking/index.mdx‎

Lines changed: 15 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ featured: true
1616

1717
Service catalogs follow a depressingly predictable arc. At launch, you've got 90% coverage and 95% accuracy — teams are entering their services because the initiative has leadership attention. By year two, coverage has dropped to 45%, accuracy to 30%, and the catalog has become a punchline in onboarding jokes. Engineers ask in Slack instead of checking the catalog because they've learned they can't trust it.
1818

19-
Here's what makes this worse: a catalog with 80% accurate data is more dangerous than no catalog at all. It gives you false confidence. You page the listed owner at 3 AM, confident you've got the right team, and waste twenty minutes before discovering they handed off the service six months ago. Every minute spent paging the wrong team is a minute your users are affected.
19+
<Highlighter>Here's what makes this worse: a catalog with 80% accurate data is more dangerous than no catalog at all. It gives you false confidence.</Highlighter> You page the listed owner at 3 AM, confident you've got the right team, and waste twenty minutes before discovering they handed off the service six months ago. Every minute spent paging the wrong team is a minute your users are affected.
2020

2121
The fix isn't discipline or better training — it's ownership modeling that captures how teams actually work, combined with enforcement automation that keeps data accurate without relying on anyone remembering to update it.
2222

@@ -31,8 +31,9 @@ But "ownership" is deceptively simple. A service might have a development team t
3131
The ownership model that works distinguishes between different types of responsibility: a __primary owner__ who's responsible for the service's existence and development, plus __role-specific contacts__ for specialized functions.
3232

3333
<Table
34-
variant="vertical-column-delineation-table"
34+
variant="numbered-review-table"
3535
content={{
36+
figure: 'Ownership roles and their triggers.',
3637
thead: {
3738
th: ['Role', 'Responsibility', 'When contacted'],
3839
},
@@ -60,7 +61,6 @@ The ownership model that works distinguishes between different types of responsi
6061
},
6162
],
6263
},
63-
figure: 'Ownership roles and their triggers.',
6464
}}
6565
/>
6666

@@ -189,8 +189,13 @@ Code: GitHub Action for catalog validation on PRs.
189189
For tier-1 and tier-2 services, make validation failures blocking. For tier-3 and tier-4, warn but allow the PR to merge — you want to reduce friction for less critical services while maintaining strict standards for critical ones.
190190

191191
<Table
192-
variant="vertical-column-delineation-table"
192+
variant="grid-and-accent-header-table"
193+
fullWidth={false}
194+
classes={{
195+
tbody: '!text-content text-center',
196+
}}
193197
content={{
198+
figure: 'Validation enforcement by tier',
194199
thead: {
195200
th: ['Service tier', 'Missing owner', 'Missing runbook', 'Missing dependencies'],
196201
},
@@ -210,11 +215,10 @@ For tier-1 and tier-2 services, make validation failures blocking. For tier-3 an
210215
},
211216
{
212217
th: 'tier-4',
213-
td: ['Warn', '—', '—'],
218+
td: ['Warn', '---', '---'],
214219
},
215220
],
216221
},
217-
figure: 'Validation enforcement by tier.',
218222
}}
219223
/>
220224

@@ -256,7 +260,11 @@ Drift detection requires API access to your identity provider, oncall system, an
256260
A catalog without health metrics will silently decay. Measuring catalog health requires tracking three dimensions: coverage (what percentage is cataloged), accuracy (does the data reflect reality), and freshness (when was it last updated).
257261

258262
<Table
259-
variant="vertical-column-delineation-table"
263+
variant="grid-and-accent-header-table"
264+
fullWidth={false}
265+
classes={{
266+
tbody: '!text-content',
267+
}}
260268
content={{
261269
thead: {
262270
th: ['Metric', 'Formula', 'Target'],

0 commit comments

Comments
 (0)