JSON and structured data
6 guidesA working reference for JSON's grammar, how to read a parser's error offset, where numbers and strings quietly lose information, and why valid JSON still gets rejected.
Read guide →Config formatsJSON, YAML and TOML: Converting Between Them Without Losing MeaningHow the three configuration formats differ in data model, comments and typing, which YAML scalars change type without warning, and what a conversion silently drops.
Read guide →Tabular dataTurning Nested JSON Into a Table Without Wrecking the DataFlattening strategies for nested JSON, the header and sparsity problems they create, RFC 4180 quoting rules, CSV formula injection, and the cases where a table is simply the wrong shape.
Read guide →Query guideJSONPath: Selectors, Filters and the Parts Implementations Disagree OnA worked reference for JSONPath selectors, slices and filter expressions, what RFC 9535 standardised in 2024, where popular libraries still differ, and when to reach for jq or JSON Pointer instead.
Read guide →XML guideValidating and Formatting XML: Well-Formed, Valid, and SafeThe difference between well-formedness and schema validity, the five escapes that actually matter, how namespaces break XPath, why pretty-printing can change meaning, and how to shut off XXE.
Read guide →Log forensicsRecovering Structure From Java toString() Output in LogsHow Java's map, collection, record and Lombok toString formats are built, why they are not JSON, a procedure for converting them back, and the ambiguities that no parser can resolve.
Read guide →Encoding and text
6 guidesWhat Base64 is actually for, how the three-byte to four-character transform works, how Base64URL and padding differ, why UTF-8 comes first, and why Base64 hides nothing.
Read guide →Regex guideHow to Test a Regular Expression ProperlyA repeatable workflow for regex: build a corpus of near-misses, read the match boundaries, understand what each flag changes, and recognise the patterns that will hang under load.
Read guide →URL guideURL Encoding Explained: Percent-Encoding, Components, and PunycodeWhich characters a URL reserves, why the rule changes per component, the difference between encodeURI and encodeURIComponent, when a plus means a space, and how internationalised domains are actually encoded.
Read guide →Escaping guideHTML Entities and Escaping by ContextWhy escaping depends on where a value lands, the rules for text, attributes, URLs, JavaScript and CSS, how named and numeric entities differ, and why context-correct output encoding — not filtering — is the defence against XSS.
Read guide →Diff guideComparing Text: A Diff Workflow That Catches Real ChangesChoosing character, word or line granularity, removing whitespace and line-ending noise, reading a unified diff hunk header, spotting moved blocks, and reviewing generated output without rubber-stamping it.
Read guide →Markdown guideCommonMark, GFM, and Writing Markdown That SurvivesWhy Markdown renders differently everywhere, what CommonMark pinned down, what GitHub Flavored Markdown adds, how raw HTML is sanitised, and how to write documents that look the same in every destination.
Read guide →Security and identifiers
6 guidesWhat the three segments of a JWT contain, why decoding proves nothing, how the registered claims are meant to be enforced, and how algorithm confusion is prevented.
Read guide →Identifier guideUUID v1, v4, v7 and the Namespace Versions: Which Should You Use?How the 128 bits of a UUID are laid out, what each version trades away, why random primary keys hurt database indexes, and what a UUID can leak about when and where it was made.
Read guide →Security guideHow to Generate a Secure Password, and What Actually Makes One StrongThe entropy arithmetic behind password strength, why length beats character-class rules, why Math.random disqualifies a generator, and why forced rotation makes passwords worse.
Read guide →Security guideHashes and Checksums: Verifying Files, and Choosing the Right AlgorithmWhat a hash function guarantees and what it does not, how to verify a download and what that verification is worth, why MD5 and SHA-1 were retired, and why password storage needs a deliberately slow algorithm.
Read guide →Security guideHow to Read a TLS Certificate: Fields, Chains, Formats and Trust ErrorsWhat each field of an X.509 certificate means, how a chain is built and why it breaks, what PEM, DER, PFX and P7B actually contain, and how to read the browser errors that follow.
Read guide →Security guideHTTP Basic Auth and htpasswd: How It Works and When to Use ItThe exact bytes Basic authentication puts on the wire, why it is useless without TLS, what each htpasswd hashing algorithm is worth, how to pick a bcrypt cost, and where Basic auth is the right answer.
Read guide →Time, numbers and formats
5 guidesField order in Unix and Quartz cron, what step and range syntax really mean, the day-of-month plus day-of-week OR rule, daylight-saving behaviour, and how to preview a schedule before you deploy it.
Read guide →Time guideUnix Timestamps and Time Zone ConversionEpoch seconds versus milliseconds, UTC versus local time, ISO 8601 versus RFC 3339, why an offset is not a time zone, how to store an instant so it survives, and what leap seconds and 2038 actually change.
Read guide →Encoding guideNumber Bases: Binary, Octal, Hex, Base32, Base64 and Base58Positional notation, why hexadecimal won, the RFC 4648 byte encodings and how they differ from numeric bases, Base58, two's complement for signed values, and where each base actually turns up.
Read guide →Database guideHow to Format SQL Queries So They Can Be ReviewedReading a query by clause structure rather than line order, dialect-sensitive identifiers and case folding, a layout that survives code review, and the class of bugs formatting exposes — plus the performance questions it cannot answer.
Read guide →Performance guideGzip Compression for DevelopersHow DEFLATE works, the difference between the gzip and zlib containers, Content-Encoding versus Transfer-Encoding, how gzip compares with brotli and zstd on real data, and the cases where compressing is worse than not compressing.
Read guide →Network and media
6 guidesWhat an IP lookup can and cannot prove, how IPv4 and IPv6 results differ on the same machine, how to read WebRTC and DNS resolver signals in a browser, and how to use IP data responsibly.
Read guide →Availability guideHow to Check Website Availability, Status, and LatencyHow to check a site along the whole request path — DNS, TCP, TLS, HTTP — tell a timeout apart from a 5xx, read a redirect chain, compare regions, and turn a one-off check into a usable incident signal.
Read guide →Proxy guideHow to Test a Proxy, Check Proxy Health, and Compare RegionsA diagnostic workflow for proxy testing: verify one endpoint before a batch, identify which stage failed, read the response correctly, compare regional exits, and handle credentials responsibly.
Read guide →WebRTC guideHow a WebRTC Peer-to-Peer Transfer Actually ConnectsThe real mechanics behind a browser-to-browser data channel: signalling, the SDP offer and answer, ICE candidate gathering, STUN and TURN, NAT behaviour, DTLS encryption, and when a relay becomes unavoidable.
Read guide →Encoding guideGenerating and Scanning QR Codes Without SurprisesHow QR codes are structured, how versions and encoding modes decide capacity, what error-correction levels really trade away, why a code fails to scan, and why scanning an unknown code is clicking an unknown link.
Read guide →Image guidePreparing ID and Passport Photos That Meet the SpecificationMillimetre sizes and the pixel arithmetic behind them, DPI explained properly, head-height ratios, background rules, file-size limits on upload forms, and an honest account of what no tool can guarantee.
Read guide →