Observe-decide-act boxes beside the message: Return the truth, guide the reader.

A 404 page answers honestly

A 404 response has two audiences. Software needs an accurate status; a person needs a useful next step. A beautifully designed error page cannot compensate for a false 200, and a correct status does not excuse an inaccessible page. Keep both parts of the response truthful without turning a missing address into a business outage. ...

July 3, 2027 · 6 min · XB Field Notes
Observe, decide, and act panels for validating sitemap entries.

Sitemaps guide crawler discovery

A sitemap gives a crawler an explicit list of URLs to consider. It is useful when new or deeply linked documents are difficult to discover through ordinary navigation. The list does not bypass authentication, grant crawl permission, guarantee indexing, or promise a revisit date. Treat it as a published inventory of intended public documents, and keep that inventory aligned with the site’s canonical URLs and actual release state. ...

June 30, 2027 · 5 min · XB Field Notes
Observe, decide, and act panels for reviewing canonical URL declarations.

Canonical URLs name a preferred representation

Several URLs can deliver the same document: a tracking parameter, alternate host, or trailing-slash variant may leave the meaningful content unchanged. A canonical link identifies the preferred representation among suitable duplicates. It helps consumers interpret that relationship, but it does not redirect an HTTP request or force a search engine to select the declared URL. The declaration is useful only when its target and surrounding signals describe the actual content relationship. ...

June 26, 2027 · 5 min · XB Field Notes
Observe, decide, and act panels for validating a well-known endpoint.

Well-known endpoints provide a discovery convention

A well-known URI gives software a conventional place to discover information associated with an origin. The reserved /.well-known/ prefix reduces collisions between independently designed protocols, and registered suffixes identify their defining specifications. The prefix is a naming mechanism, not an implementation or a guarantee of trustworthy content. A server must still route the selected endpoint correctly, and a client must interpret the response according to that endpoint’s own contract. ...

June 22, 2027 · 5 min · XB Field Notes
A metadata hint that fixes how a text payload is turned into characters.

A charset tells the reader how the bytes become characters

Character encoding connects bytes to characters. In text/plain; charset=utf-8, the charset parameter names that connection; changing the parameter does not change the payload. Reliable text delivery requires agreement between the producer’s actual encoding and the consumer’s decoding rules, not simply the appearance of the word UTF-8 in a configuration file. ...

March 5, 2027 · 4 min · XB Field Notes
Three connected blocks labeled Observe, Decide, and Act.

CORS preflight depends on the request shape

CORS preflight asks whether a browser may send a particular cross-origin request shape. It is an OPTIONS request containing the proposed method and relevant request-header names. The browser checks the server’s response before sending the actual request. This mechanism is distinct from checking whether application JavaScript may read an actual response that has already arrived. Both stages can fail, but their effects on server-side execution differ. ...

January 22, 2027 · 5 min · XB Field Notes
An operator-friendly web server that wires ACME into a plain config file.

Caddy automates HTTPS issuance and renewal

The automation wraps the ACME protocol yet still obeys the same public rules: challenges are validated over the network, and when the origin is hidden behind a load balancer you may need the DNS challenge instead of the HTTP one. One directive is enough A bare caddy file-server (or a tls directive) turns automatic HTTPS on by default: Caddy generates a key pair and drives the ACME flow against a certificate authority to obtain a certificate, then reloads it into the running server. It stores the issued key and certificate in its own data store under an ID derived from the domain, so the next start reuses them instead of re-issuing on every boot. You never author the protocol steps, but you still own the boundaries: a domain must be publicly reachable, or you switch to a DNS challenge with a provider plugin so the validation runs where it can actually answer. ...

January 21, 2027 · 5 min · XB Field Notes
A response attaching named relationships to other resources.

The Link header relates adjacent resources

The Link response field describes relationships between the current resource and other resources. An API returning JSON can advertise its next page without making clients scrape HTML or invent a query parameter. The field supplies a target and a relation; whether to follow it remains a client decision. It is useful metadata, not a command that every browser or crawler must execute. ...

December 4, 2026 · 4 min · XB Field Notes