Skip to content

Commit 33f491a

Browse files
committed
Move first batch of cover prompts to COVERS.md
1 parent 2c8c355 commit 33f491a

10 files changed

Lines changed: 115 additions & 97 deletions

File tree

.vscode/settings.json

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -139,6 +139,7 @@
139139
"Tursa",
140140
"Turso",
141141
"tydata",
142+
"unsampled",
142143
"unspaced",
143144
"unstub",
144145
"uppy",

COVERS.md

Lines changed: 97 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,4 +22,100 @@ Create a visual metaphor showing a radar or sonar screen with a single bright, c
2222

2323
### Prompt 5: The Alert Audit Dashboard
2424

25-
Illustrate a stylized monitoring dashboard showing alert metrics transforming from chaotic (left side: crowded charts, red indicators, overwhelmed UI) to clean (right side: sparse, green indicators, clear hierarchy). The transition should flow naturally across the image. Style: UI/UX focused illustration, modern SaaS aesthetic, subtle gradients, professional color palette, 16:9 aspect ratio.
25+
Illustrate a stylized cloud monitoring dashboard showing alert metrics transforming from chaotic (left side: crowded charts, red indicators, overwhelmed UI) to clean (right side: sparse, green indicators, clear hierarchy). The transition should flow naturally across the image. Style: UI/UX focused illustration, modern SaaS aesthetic, subtle gradients, professional color palette, 16:9 aspect ratio.
26+
27+
## api-deprecation-sunset-headers-consumer-migration
28+
29+
title: "API Deprecation Playbooks That Work"
30+
31+
### Prompt 1: Sunset Over API Architecture
32+
33+
Create a dramatic sunset scene where the sun is setting behind a stylized cityscape made of API endpoint blocks and server racks. The fading light casts long shadows over deprecated v1 endpoints while new v2 endpoints glow with fresh morning light on the opposite horizon. Style: architectural illustration meets nature photography, warm orange and purple sunset colors transitioning to cool blue dawn, 16:9 aspect ratio.
34+
35+
### Prompt 2: Migration Bridge Metaphor
36+
37+
Illustrate a grand suspension bridge spanning a digital chasm. On one side, legacy API infrastructure (older, weathered styling). On the other, modern API architecture (clean, glowing). Consumers (represented as small vehicles or data packets) are crossing the bridge. Some legacy infrastructure is beginning to crumble. Style: isometric digital illustration, tech-meets-infrastructure aesthetic, blue and orange color scheme, 16:9 aspect ratio.
38+
39+
### Prompt 3: Countdown Timer Visualization
40+
41+
Design an abstract visualization of a large digital countdown timer (showing "30 DAYS REMAINING") surrounded by flowing streams of API traffic gradually redirecting from old endpoints (red/orange streams) to new endpoints (green/blue streams). The deprecated endpoints should be visually fading. Style: data visualization art, dark background with glowing elements, motion blur on traffic streams, 16:9 aspect ratio.
42+
43+
### Prompt 4: Communication Network Deprecation
44+
45+
Create an illustration showing a network of connected nodes (API consumers) receiving deprecation signals. Central broadcast tower sending out warning waves. Some nodes are updated (green), some are receiving warnings (yellow), some are ignoring signals (red). The red nodes should have visual representation of warning headers bouncing off them. Style: network topology visualization, broadcast/signal aesthetic, muted colors with warning highlights, 16:9 aspect ratio.
46+
47+
### Prompt 5: Version Evolution Timeline
48+
49+
Illustrate a horizontal timeline showing API version evolution from v1 to v3. V1 is archaeological/fossil-like (being excavated), v2 is current and thriving (active, glowing), v3 is emerging (blueprint/wireframe style). Include visual representations of sunset headers as amber warning lights above v1. Style: timeline infographic illustration, evolution/archaeology meets technology, warm to cool color gradient left to right, 16:9 aspect ratio.
50+
51+
## api-gateway-metrics-traces-logs-debugging
52+
53+
title: "API Gateway Observability That Actually Helps"
54+
55+
### Prompt 1: Three Pillars Visualization
56+
57+
Create an architectural illustration showing three glowing pillars (metrics, traces, logs) supporting an API gateway structure. Data flows through the gateway as luminous streams, with each pillar capturing different aspects of the flow. The pillars should be interconnected with subtle light bridges representing correlation. Style: modern tech architecture illustration, dark background with cyan/blue/purple glow effects, isometric perspective, 16:9 aspect ratio.
58+
59+
### Prompt 2: Request Flow X-Ray
60+
61+
Illustrate an API gateway as a transparent glass structure with a request traveling through it. The request path is illuminated like an X-ray or MRI scan, showing internal components (auth, rate limiting, routing) as the request passes through. Upstream services visible on the other side. Style: medical imaging meets tech visualization, blue monochrome with highlight colors for key components, cross-section view, 16:9 aspect ratio.
62+
63+
### Prompt 3: Observatory Control Room
64+
65+
Design a stylized observatory/mission control room with multiple screens showing gateway dashboards, trace waterfalls, and log streams. An operator (silhouette) monitors the displays. The central screen shows a request path diagram. Style: retro-futuristic control room aesthetic, dark room with glowing screens, NASA mission control inspiration, 16:9 aspect ratio.
66+
67+
### Prompt 4: Signal Through Noise
68+
69+
Create an abstract visualization of a clear signal (representing useful observability data) emerging from a chaotic field of noise. The gateway sits at the center, acting as a filter that transforms raw data streams into organized, colored channels (red for metrics, blue for traces, green for logs). Style: data art, abstract flowing forms, dark background with vibrant data streams, motion blur effects, 16:9 aspect ratio.
70+
71+
### Prompt 5: Connected Spans Constellation
72+
73+
Illustrate distributed trace spans as a constellation of connected stars. The gateway span is the bright central star, with upstream and downstream service spans connected by trace context lines. Each span shows timing information as light intensity. Background shows faint unconnected spans (unsampled requests). Style: astronomical visualization, dark space background, constellation-style connections, warm golden spans against cool blue background, 16:9 aspect ratio.
74+
75+
## api-usage-metering-quotas-cost-attribution
76+
77+
title: "API Cost Management: Metering, Quotas, Chargebacks"
78+
79+
### Prompt 1: Metering Pipeline Flow
80+
81+
Create a stylized visualization of data flowing through a metering pipeline. API requests enter as streams of light, pass through measurement gates that capture dimensions (counters, timers, gauges), and aggregate into glowing usage buckets. Final output shows cost calculations. Style: data flow visualization, dark background with luminous data streams, tech-forward aesthetic, blue and gold color scheme, 16:9 aspect ratio.
82+
83+
### Prompt 2: Quota Gauge Dashboard
84+
85+
Illustrate a sleek dashboard interface showing multiple circular gauge meters for different quota dimensions (requests, compute, storage). Some gauges are in green (safe), one is in yellow (warning), one approaching red (limit). Clean, modern SaaS dashboard aesthetic with subtle depth and shadows. Style: UI design illustration, dark mode dashboard, gradient fills on gauges, professional enterprise aesthetic, 16:9 aspect ratio.
86+
87+
### Prompt 3: Cost Attribution Breakdown
88+
89+
Design an abstract visualization of cost allocation. A central "cost pool" (represented as a glowing sphere or container) distributes costs to different consumers represented as receiving nodes of varying sizes. Connection lines show attribution flow with dollar amounts. Style: network/flow diagram aesthetic, financial visualization meets tech, green/blue gradient for money flow, dark background, 16:9 aspect ratio.
90+
91+
### Prompt 4: Usage Tiers Staircase
92+
93+
Create an isometric illustration of ascending staircases/platforms representing pricing tiers. Lower tiers are crowded with small consumers, higher tiers have fewer but larger consumers. Each tier shows a price tag and usage range. Visual metaphor for volume-based pricing. Style: isometric illustration, clean geometric shapes, tiered gradient colors (light to premium), minimalist tech aesthetic, 16:9 aspect ratio.
94+
95+
### Prompt 5: Billing Cycle Timeline
96+
97+
Illustrate a horizontal timeline showing the billing cycle: usage events flowing in continuously, aggregation checkpoints, end-of-period invoice generation, and payment processing. Each stage represented as a distinct station on the timeline with appropriate iconography. Style: timeline infographic, process visualization, dark theme with accent colors for each stage, modern fintech aesthetic, 16:9 aspect ratio.
98+
99+
## api-versioning-deprecation-sunset-headers-migration
100+
101+
title: "API Versioning: Deprecation Without Breaking Consumers"
102+
103+
### Prompt 1: Version Branches Diverging
104+
105+
Create an illustration of a single path (representing an API) that branches into multiple diverging roads labeled v1, v2, v3. The v1 road is fading/becoming overgrown (deprecated), v2 is a well-maintained highway (current), and v3 is under construction (preview). Signposts show sunset dates and migration directions. Style: stylized map/journey illustration, warm earth tones with blue accents, bird's eye view perspective, 16:9 aspect ratio.
106+
107+
### Prompt 2: Version Lifecycle State Machine
108+
109+
Design a visualization of the API version lifecycle as interconnected glowing nodes: Preview (blue/experimental), Stable (green/solid), Deprecated (amber/warning), Sunset (red/fading). Animated particle flows show versions transitioning between states. Dark background with neon-style glowing connections. Style: abstract state machine visualization, tech-forward aesthetic, dark mode with vibrant state colors, 16:9 aspect ratio.
110+
111+
### Prompt 3: Migration Bridge Construction
112+
113+
Illustrate engineers building a bridge from an old API platform (v1, showing wear) to a new modern platform (v2, clean and bright). Some traffic (data packets/consumers) is already crossing, others are waiting on the v1 side. Construction cranes represent migration tooling. Style: isometric illustration, construction meets technology, warm to cool color transition left to right, 16:9 aspect ratio.
114+
115+
### Prompt 4: Sunset Header Beacon
116+
117+
Create a lighthouse scene where the lighthouse beam sweeps over an API landscape, illuminating deprecated endpoints with warning light. Ships (consumers) navigate toward the newer, well-lit harbor (v2). The sunset colors in the sky reinforce the "sunset" theme. Style: nautical meets tech, dramatic sunset lighting, warm orange/purple sky gradient, beacon light cutting through, 16:9 aspect ratio.
118+
119+
### Prompt 5: Version Timeline Evolution
120+
121+
Design a horizontal timeline showing API version evolution as geological strata or tree rings. Oldest versions (v1) at the bottom/center showing fossil-like imprints, current version (v2) as the active growing layer, future version (v3) as emerging growth. Cross-section view reveals the layered history. Style: natural history meets technology, earth tones with tech highlights, scientific illustration aesthetic, 16:9 aspect ratio.

_TODO.md

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
11
<!-- markdownlint-disable-file -->
22
# TODO
33

4+
Clear All Workspace Chats
5+
46
## E2E Files with Skipped Tests
57

68
Blocked Categories (44 tests):
@@ -94,15 +96,26 @@ if (window.matchMedia) {
9496
- flux pro - text-to-image and image-to-image generation, developed by Black Forest Labs, known for its exceptional speed, high visual quality, and superior prompt adherence, offering features like advanced editing, video generation, and context-aware understanding through platforms like Flux.ai, Fal.ai, and Skywork.ai. It serves as a professional-grade creative tool, balancing performance with user-friendly access for detailed content creation.
9597
- nano banana (Google)
9698
- sd3 (Stability AI's Stable Diffusion 3, open source)
99+
- Seedream 4.0 model from ByteDance
100+
101+
Considered excellent for text-to-image (T2I) tasks and is a top competitor in the field. It has been highly rated in benchmarks and is praised for its high-quality, realistic output and strong prompt adherence.
102+
103+
Key Features for Text-to-Image Generation
104+
105+
High Performance: The model performs well across core dimensions like prompt adherence, alignment, and aesthetics, often ranking first in internal and public evaluations.
106+
107+
Aesthetics and Realism: It generates images that are very realistic, with impressive texture, lighting, and color, making it difficult to distinguish them from real photographs in some cases.
108+
109+
High Resolution: Seedream 4.0 is capable of generating native high-resolution images, up to 4K (4096px), which is a significant advantage over many competing models that are often capped at 2K.
110+
111+
Complex Text and Instruction Following: The model demonstrates an enhanced understanding of complex semantic prompts and excels in rendering dense and accurate text within the generated images, a common weakness in other AI image models.
97112

98113
## Move Tags Page
99114

100115
The /tags route is really just the /articles route but better. We should redirect from /tags to /articles, and fix the breadcrumb so that it goes to /articles if someone clicks on the /tags part.
101116

102117
## Content Instructions
103118

104-
105-
106119
We have generated detailed outlines for each of the MDX proposed articles we have in src/content/articles. It's time to write our articles. Review ./CONTENT.md for the goals and voice to use in our website. Each outline includes various components we use on our site that can be incorporated into the final article but do not have to be included if they don't fit into the content well or are excessive.
107120

108121
Act as a principal software engineer. Your goal is to write a detailed technical article based on the provided outline. Context: The target audience is Senior DevOps and infrastructure Engineers. The tone should be authoritative, professional, and concise, avoiding fluff or filler words. Think step-by-step before writing to improve the accuracy of technical explanations. Use a friendly first-person voice. Anything that reads like generic marketing copy is not what we want but we still want the effect of being "real" and approachable - try not to sound like technical documentation. We want to show empathy for our readers.

src/content/articles/api-deprecation-sunset-headers-consumer-migration/index.mdx

Lines changed: 0 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -484,26 +484,3 @@ Summarize the key principles: communicate early and often, track usage obsessive
484484
Successful deprecation is measured by what does not happen: no outages, no angry customers, and no deprecated endpoints lingering years past their sunset date.
485485
</Callout>
486486

487-
---
488-
489-
## Cover Prompt
490-
491-
### Prompt 1: Sunset Over API Architecture
492-
493-
Create a dramatic sunset scene where the sun is setting behind a stylized cityscape made of API endpoint blocks and server racks. The fading light casts long shadows over deprecated v1 endpoints while new v2 endpoints glow with fresh morning light on the opposite horizon. Style: architectural illustration meets nature photography, warm orange and purple sunset colors transitioning to cool blue dawn, 16:9 aspect ratio.
494-
495-
### Prompt 2: Migration Bridge Metaphor
496-
497-
Illustrate a grand suspension bridge spanning a digital chasm. On one side, legacy API infrastructure (older, weathered styling). On the other, modern API architecture (clean, glowing). Consumers (represented as small vehicles or data packets) are crossing the bridge. Some legacy infrastructure is beginning to crumble. Style: isometric digital illustration, tech-meets-infrastructure aesthetic, blue and orange color scheme, 16:9 aspect ratio.
498-
499-
### Prompt 3: Countdown Timer Visualization
500-
501-
Design an abstract visualization of a large digital countdown timer (showing "30 DAYS REMAINING") surrounded by flowing streams of API traffic gradually redirecting from old endpoints (red/orange streams) to new endpoints (green/blue streams). The deprecated endpoints should be visually fading. Style: data visualization art, dark background with glowing elements, motion blur on traffic streams, 16:9 aspect ratio.
502-
503-
### Prompt 4: Communication Network Deprecation
504-
505-
Create an illustration showing a network of connected nodes (API consumers) receiving deprecation signals. Central broadcast tower sending out warning waves. Some nodes are updated (green), some are receiving warnings (yellow), some are ignoring signals (red). The red nodes should have visual representation of warning headers bouncing off them. Style: network topology visualization, broadcast/signal aesthetic, muted colors with warning highlights, 16:9 aspect ratio.
506-
507-
### Prompt 5: Version Evolution Timeline
508-
509-
Illustrate a horizontal timeline showing API version evolution from v1 to v3. V1 is archaeological/fossil-like (being excavated), v2 is current and thriving (active, glowing), v3 is emerging (blueprint/wireframe style). Include visual representations of sunset headers as amber warning lights above v1. Style: timeline infographic illustration, evolution/archaeology meets technology, warm to cool color gradient left to right, 16:9 aspect ratio.

src/content/articles/api-gateway-metrics-traces-logs-debugging/index.mdx

Lines changed: 0 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -711,27 +711,3 @@ Summarize the key principles: measure what matters for debugging (not vanity met
711711
<Callout type="success">
712712
The goal of gateway observability is to make the gateway transparent. When debugging, you should see the request flow through the gateway as clearly as if the gateway were not there.
713713
</Callout>
714-
715-
---
716-
717-
## Cover Prompt
718-
719-
### Prompt 1: Three Pillars Visualization
720-
721-
Create an architectural illustration showing three glowing pillars (metrics, traces, logs) supporting an API gateway structure. Data flows through the gateway as luminous streams, with each pillar capturing different aspects of the flow. The pillars should be interconnected with subtle light bridges representing correlation. Style: modern tech architecture illustration, dark background with cyan/blue/purple glow effects, isometric perspective, 16:9 aspect ratio.
722-
723-
### Prompt 2: Request Flow X-Ray
724-
725-
Illustrate an API gateway as a transparent glass structure with a request traveling through it. The request path is illuminated like an X-ray or MRI scan, showing internal components (auth, rate limiting, routing) as the request passes through. Upstream services visible on the other side. Style: medical imaging meets tech visualization, blue monochrome with highlight colors for key components, cross-section view, 16:9 aspect ratio.
726-
727-
### Prompt 3: Observatory Control Room
728-
729-
Design a stylized observatory/mission control room with multiple screens showing gateway dashboards, trace waterfalls, and log streams. An operator (silhouette) monitors the displays. The central screen shows a request path diagram. Style: retro-futuristic control room aesthetic, dark room with glowing screens, NASA mission control inspiration, 16:9 aspect ratio.
730-
731-
### Prompt 4: Signal Through Noise
732-
733-
Create an abstract visualization of a clear signal (representing useful observability data) emerging from a chaotic field of noise. The gateway sits at the center, acting as a filter that transforms raw data streams into organized, colored channels (red for metrics, blue for traces, green for logs). Style: data art, abstract flowing forms, dark background with vibrant data streams, motion blur effects, 16:9 aspect ratio.
734-
735-
### Prompt 5: Connected Spans Constellation
736-
737-
Illustrate distributed trace spans as a constellation of connected stars. The gateway span is the bright central star, with upstream and downstream service spans connected by trace context lines. Each span shows timing information as light intensity. Background shows faint unconnected spans (unsampled requests). Style: astronomical visualization, dark space background, constellation-style connections, warm golden spans against cool blue background, 16:9 aspect ratio.

0 commit comments

Comments
 (0)