Skip to content

Commit 10ecbae

Browse files
committed
Fix build errors related to Table and List component props during refactor
1 parent 42866c4 commit 10ecbae

83 files changed

Lines changed: 7382 additions & 9700 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

COVERS.md

Lines changed: 0 additions & 1894 deletions
This file was deleted.

MERMAID.md

Lines changed: 158 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,158 @@
1+
# Mermaid usage
2+
3+
## src/content/articles/opentelemetry-span-design-granularity-overhead/pdf.mdx
4+
5+
```mermaid
6+
gantt
7+
title Trace Waterfall (readable)
8+
dateFormat X
9+
axisFormat %L ms
10+
11+
section Request
12+
HTTP GET /orders/123 :a1, 0, 150
13+
14+
section Cache
15+
cache.get :a2, 5, 15
16+
17+
section Database
18+
db.query orders :a3, 20, 80
19+
20+
section Enrichment
21+
enrichOrder :a4, 85, 140
22+
http.get /customers/456 :a5, 90, 120
23+
http.get /products/789 :a6, 90, 110
24+
```
25+
Figure: Readable trace waterfall with clear hierarchy.
26+
27+
```mermaid
28+
flowchart TD
29+
A[Incoming Request] --> B{Head Sampling?}
30+
31+
B -->|Yes| C[Create Spans]
32+
B -->|No| D[No Spans Created]
33+
34+
C --> E[Export to Collector]
35+
E --> F{Tail Sampling?}
36+
37+
F -->|Error?| G[Keep]
38+
F -->|Slow?| G
39+
F -->|High-value?| G
40+
F -->|Random 5%| G
41+
F -->|Otherwise| H[Drop]
42+
43+
G --> I[Storage Backend]
44+
45+
style D fill:#f96,color:#000
46+
style H fill:#f96,color:#000
47+
style G fill:#9f9,color:#000
48+
```
49+
Figure: Head sampling reduces overhead; tail sampling preserves interesting traces.
50+
51+
```mermaid
52+
gantt
53+
title Trace Waterfall (over-instrumented)
54+
dateFormat X
55+
axisFormat %L ms
56+
57+
section Request
58+
HTTP GET /orders/123 :a1, 0, 150
59+
60+
section Validation
61+
validate.request :a2, 2, 5
62+
parse.json :a3, 5, 8
63+
validate.orderId :a4, 8, 10
64+
65+
section Cache
66+
cache.get :a5, 10, 12
67+
serialize.key :a6, 10, 11
68+
redis.get :a7, 11, 12
69+
deserialize.result :a8, 12, 13
70+
71+
section Database
72+
db.getConnection :a9, 15, 18
73+
db.query orders :a10, 18, 75
74+
db.releaseConnection :a11, 75, 77
75+
map.toEntity :a12, 77, 79
76+
77+
section Response
78+
serialize.json :a13, 140, 145
79+
set.headers :a14, 145, 147
80+
send.response :a15, 147, 150
81+
```
82+
Figure: Over-instrumented trace—wall of spans obscures the critical path.
83+
84+
```mermaid
85+
sequenceDiagram
86+
participant Client
87+
participant API as API Service
88+
participant Cache
89+
participant DB as Database
90+
participant Customers as Customers Service
91+
92+
Client->>API: GET /orders/123
93+
Note over API: Root span: HTTP GET /orders/{id}
94+
95+
API->>Cache: Get order:123
96+
Note over API: Child span: cache.get
97+
Cache-->>API: Miss
98+
99+
API->>DB: SELECT * FROM orders
100+
Note over API: Child span: db.query orders
101+
DB-->>API: Order data
102+
103+
API->>Customers: GET /customers/456
104+
Note over API: Child span: HTTP GET customers-service
105+
Note over Customers: Continues trace
106+
Customers-->>API: Customer data
107+
108+
API-->>Client: Enriched order
109+
Note over API: Root span ends
110+
```
111+
Figure: Request instrumentation sequence.
112+
113+
```mermaid
114+
flowchart LR
115+
subgraph correct[Correct: 1-100 spans]
116+
B1[batch.process] --> E1[item.failed event]
117+
B1 --> E2[item.failed event]
118+
B1 --> A1[batch.successful: 9998]
119+
end
120+
121+
subgraph wrong[Wrong: 10,000 spans]
122+
I1[process.item] --> I2[process.item]
123+
I2 --> I3[process.item]
124+
I3 --> I4[...9,997 more...]
125+
end
126+
127+
style correct fill:#9f9,color:#000
128+
style wrong fill:#f96,color:#000
129+
```
130+
Figure: Batch instrumentation approaches—events vs spans.
131+
132+
## src/content/articles/platform-architecture-control-plane-data-plane-separation/index.mdx
133+
134+
```mermaid
135+
graph TB
136+
subgraph CP[Control Plane]
137+
A[API Server] --> B[State Store]
138+
A --> C[Controllers]
139+
end
140+
141+
D[Isolation Boundary]
142+
143+
subgraph DP[Data Plane]
144+
F[Worker Node 1]
145+
G[Worker Node 2]
146+
H[Worker Node 3]
147+
end
148+
149+
C -->|"Desired State"| D
150+
D --> F
151+
D --> G
152+
D --> H
153+
154+
F -->|"Actual State"| D
155+
G -->|"Actual State"| D
156+
H -->|"Actual State"| D
157+
D --> C
158+
```
File renamed without changes.

TROUBLESHOOTING_HEADER_SPACING.md

Lines changed: 0 additions & 195 deletions
This file was deleted.

_TODO.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -319,10 +319,6 @@ An example is as follows:
319319

320320
The first file to update is:
321321

322-
Files with missed lists:
323-
324-
src/content/articles/eol-runtime-upgrade-dependency-hell-migration/index.mdx
325-
326322
### Timelines
327323

328324
- Good generation:
@@ -342,3 +338,7 @@ argocd-sync-failures-gitops-debugging-troubleshooting/resource-dependency-graph-
342338
### Figure captions are broken:
343339

344340
src/content/articles/structured-logging-correlation-ids-log-schema-design/pdf.mdx
341+
342+
### This file was badly mangled during refactoring, need to compare against original:
343+
344+
src/content/articles/internal-developer-portal-platform-self-service-actions/pdf.mdx

src/content/articles/eol-runtime-upgrade-dependency-hell-migration/index.mdx

Lines changed: 17 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -37,9 +37,23 @@ Once you have visibility, classify blockers by type. Not all incompatibilities a
3737

3838
The order matters. The general pattern I follow:
3939

40-
1. __Unblock first.__ Eliminate packages that have no path forward on the new runtime. If you're stuck on Node 16 because of `node-sass`, replacing it with Dart Sass is the first step—not because it's the most important change, but because everything else depends on it. These blockers sit at the bottom of your dependency graph, and until they're gone, you cannot move.
41-
2. __Upgrade core dependencies.__ These are the major libraries that define your application's architecture: your ORM, your web framework, your authentication library. They often have breaking changes between major versions, but they're also well-documented, with migration guides and changelogs. Do these upgrades _while you're still on the old runtime_. That way, if something breaks, you know it's the library upgrade, not the runtime change.
42-
3. __Change the runtime last.__ By the time you change the Node version or .NET target framework, every dependency should already be compatible. The runtime switch itself should be anticlimactic—a container base image change and a CI configuration update. If you've done the preparation correctly, your tests pass on the first try.
40+
<List
41+
variant="numbered-with-background-list"
42+
items={[
43+
{
44+
lead: "Unblock first.",
45+
text: "Eliminate packages that have no path forward on the new runtime. If you're stuck on Node 16 because of `node-sass`, replacing it with Dart Sass is the first step—not because it's the most important change, but because everything else depends on it. These blockers sit at the bottom of your dependency graph, and until they're gone, you cannot move.",
46+
},
47+
{
48+
lead: "Upgrade core dependencies.",
49+
text: "These are the major libraries that define your application's architecture: your ORM, your web framework, your authentication library. They often have breaking changes between major versions, but they're also well-documented, with migration guides and changelogs. Do these upgrades _while you're still on the old runtime_. That way, if something breaks, you know it's the library upgrade, not the runtime change.",
50+
},
51+
{
52+
lead: "Change the runtime last.",
53+
text: "By the time you change the Node version or .NET target framework, every dependency should already be compatible. The runtime switch itself should be anticlimactic—a container base image change and a CI configuration update. If you've done the preparation correctly, your tests pass on the first try.",
54+
},
55+
]}
56+
/>
4357

4458
<Callout type="warning">
4559
Don't skip intermediate versions when the gap is large. Jumping from Node 14 to Node 20 means debugging breakage from three major versions simultaneously. Go 14 → 16 → 18 → 20, validating at each step. The extra time is worth the clarity.

src/content/articles/helm-release-management-drift-detection-debugging/index.mdx

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -186,18 +186,18 @@ Drift is inevitable in any cluster where humans and automation coexist. The goal
186186
title="Download the Helm Operations Guide"
187187
description="Get the complete release-management playbook for Helm drift detection, rollback recovery, and reliable upgrade workflows."
188188
listItems={[
189-
{
190-
text: "Drift detection automation patterns",
191-
},
192-
{
193-
text: "Failed rollback triage workflow",
194-
},
195-
{
196-
text: "Release inventory governance guide",
197-
},
198-
{
199-
text: "GitOps integration decision matrix",
200-
},
189+
{
190+
text: "Drift detection automation patterns",
191+
},
192+
{
193+
text: "Failed rollback triage workflow",
194+
},
195+
{
196+
text: "Release inventory governance guide",
197+
},
198+
{
199+
text: "GitOps integration decision matrix",
200+
},
201201
]}
202202
/>
203203

0 commit comments

Comments
 (0)