User Journey Diagrams with Mermaid

Mermaid user journey diagrams turn fuzzy “user clicks around” stories into clear stages, tasks, and friction points. Learn the journey syntax, scoring (0–5), multiple actors (support/billing), and how to pair journeys with flowcharts or sequence diagrams to make improvements actionable.

Read More »

WordPress “The link you followed has expired” — Fixing Upload POST Size Limits (Apache proxy_fcgi + PHP-FPM)

WordPress’s “The link you followed has expired” is often a misleading symptom of a server-side upload rejection. When PHP (or the web server) refuses a large POST body—like a theme/plugin ZIP—WordPress never receives the request and falls back to that generic message. The fix is to raise post_max_size and upload_max_filesize (plus a sensible memory_limit), restart PHP-FPM, and re-try the upload.

Read More »

State Diagrams for Lifecycle Modeling with Mermaid

State diagrams answer a different question than flowcharts and sequence diagrams. Flowcharts: What steps happen? Sequence diagrams: What calls happened in what order? State diagrams: What states can this thing be in, and what events move it between states? If you’ve ever tried to explain “healthy → draining → terminated” (or “closed → open → half-open”), a state diagram is usually the cleanest way to do it. This post focuses on Mermaid state diagrams for modeling lifecycles you’ll actually run into in ops and engineering: deploys, load balancers, workers, and circuit breakers. A quick refresher: the minimum you need Mermaid’s modern syntax is stateDiagram-v2. Source

Rendered Conventions worth adopting Use nouns for states: Healthy, Draining, Degraded Use verbs/events on arrows: timeout, deploy, deregister, success Keep labels short; if you need paragraphs, add a note or link to a runbook 1) Model “system lifecycle” states (a great first use) Many

Read More »

Min, Max, Mean, Average, P90, P95, and P99: What They Mean (and When to Use Them)

If you’ve ever looked at system metrics, API latency charts, or a performance report, you’ve probably seen a mix of terms like minimum, maximum, mean, average, and percentile values like p90, p95, and p99. They all describe “what the numbers look like,” but they answer different questions. Picking the wrong one can hide real problems—or make healthy systems look broken. This guide explains what each metric means, how to interpret it, and which one to use for common monitoring and reporting scenarios. A quick mental model Imagine you measure the response time for 10,000 requests over a minute. You now have a list of numbers (one per request). Summary statistics help you describe that list: Min/Max: the extremes Mean/Average: the center (one kind of “typical”) Percentiles (p90/p95/p99): “how bad it gets for the slowest X% of requests” Minimum (min) Definition: The smallest observed value. What it answers: “What’s the fastest

Read More »

Force a 404 With a CloudFront Function (Always)

Need everything behind a CloudFront distribution to return “Not Found” instantly—without touching your origin? Here’s a tiny CloudFront Function you can attach at Viewer Request to short-circuit all traffic and consistently respond with a 404 (plus no-cache headers).

Read More »

HTTP Basic Auth Is Dead

HTTP Basic Auth used to be the go-to “quick gate” for staging sites and temporary protection. In 2026 it’s functionally broken: modern browser behavior is moving away from reliable prompt-based auth, and WordPress speculative loading now triggers background requests that make Basic Auth unreliable in real-world deployments.

Read More »

WordPress 6.8 Speculative Loading Can Break HTTP Basic Auth

WordPress 6.8’s new Speculative Loading feature can trigger background requests that break HTTP Basic Auth–protected staging sites. Disabling speculative loading may help — but real-world testing shows it’s not always sufficient, and it may be time to rethink Basic Auth as a staging gate.

Read More »

GitGraph for Release and Branch Strategy with Mermaid

Mermaid GitGraph diagrams make branching strategy easy to explain and hard to misinterpret. This guide shows trunk-based development, release branches, hotfixes, backports, and GitFlow patterns—with tags and “merge forward” rules you can copy into your engineering docs.

Read More »

Gantt Charts for Infra Work with Mermaid

Mermaid Gantt charts are a simple way to plan infra work: phases, dependencies, milestones, parallel tasks, and rollback lanes. This guide shows practical patterns for maintenance windows, migrations, and staged rollouts with copy/paste examples.

Read More »

INSTANT ALERTS!

FRESH FROM THE ICE

GET A QUICK EMAIL THE MOMENT A NEW ARTICLE HITS THE BLOG.

We don’t spam! Read our privacy policy for more info.

Get a free consultation from Reliable Penguin

Submit the form—or for immediate service call 866-649-7984.