Categories, Tags, or Collections? How to Organize Reference Data
How to organize reference data with one category per dataset, controlled tags and curated collections, using counts from a 205-dataset catalog.
Read post →Reference guides, cheat sheets, and explainers on HTTP, SQL, Unix, data formats, and LLM tooling — written for developers and agents.
New from the author: How to Remain Valuable When Intelligence Becomes Cheap — 224 pages on the work AI can’t commoditize.
How to organize reference data with one category per dataset, controlled tags and curated collections, using counts from a 205-dataset catalog.
Read post →A practical checklist for cleaning a reference dataset before you publish it: check row shapes, null values, duplicate keys and label spelling.
Read post →Build bounded API retries that respect Retry-After, avoid duplicate writes, and distinguish transport failures from invalid requests.
Read post →Design retryable workers that survive duplicate delivery and crashes between database commits and event publication.
Read post →Select a probability model by support, data-generating assumptions, and parameter conventions before fitting a familiar curve.
Read post →Choose PostgreSQL indexes from actual filters, ordering, selectivity, and EXPLAIN output instead of indexing every column.
Read post →A concurrent counter example shows why transactions alone do not prevent lost updates and when to use atomic or conditional writes.
Read post →Use a judged query set to separate missing evidence, poor ranking, duplicate context, and generation errors in a RAG workflow.
Read post →Check assignment, measurement, stopping rules, missingness, and uncertainty before treating a product metric change as causal evidence.
Read post →A worked HTTP caching example: freshness, ETag validation, 304 responses, and a safe cache policy for public reference files.
Read post →Make search dialogs and wide reference tables usable with a keyboard, narrow screens, and reduced motion.
Read post →Build a practical evaluation for factual lookup, evidence coverage, abstention, and tool outcomes without trusting one aggregate score.
Read post →A practical observability plan for a small API: meaningful denominators, operation IDs, latency distributions, and actionable alerts.
Read post →Inspect, preserve, and recover commits or selected files with reflog, restore, and revert while protecting concurrent local work.
Read post →Roll out CSP and browser security headers with a resource inventory, report-only checks, and concrete compatibility tests.
Read post →Worked PostgreSQL examples for running totals, stable rankings, peer rows, and explicit window frames.
Read post →Choose explicit timestamp units, preserve local scheduling intent, and avoid double-counting events at reporting boundaries.
Read post →Handle composed text, accents, Turkish casing, and confusable identifiers while preserving original multilingual content.
Read post →A small JSON Schema contract for a reference table, plus missing-field, extra-field, and semantic validation checks.
Read post →Grok Bot, Meta Muse, ChatGPT Dots, OpenClaw and Hermes compared: what each agent does, rented vs owned, who it is for and what it costs. With an 8-minute film.
Read post →awk vs sed vs grep explained with examples: search lines, edit streams, and process columns — the Unix text toolkit in one guide.
Read post →Big O notation explained simply: O(1) to O(n!) with examples, a cheat sheet table, and tips for estimating complexity.
Read post →CAP theorem says a distributed database can guarantee only two of consistency, availability, and partition tolerance. Learn what that means in practice.
Read post →CORS blocks browser requests across origins unless the server allows them. Learn how preflights work and how to configure CORS headers correctly.
Read post →Cron jobs explained: the five time fields, copy-paste schedules, crontab management, common failures, and when to upgrade to a real scheduler.
Read post →Docker commands cheat sheet: run, exec, logs, build, volumes, networks, compose, and cleanup — the 20 commands behind the daily container workflow.
Read post →Git branching workflows compared: GitHub Flow, Git Flow, trunk-based development, and GitLab Flow — commands, trade-offs, and which team each suits.
Read post →HTTP caching headers explained: Cache-Control directives, ETag validation, Last-Modified, and strategies for APIs and static assets.
Read post →JSON Schema validation primer: types, required fields, enums, nested objects, arrays, and how to validate payloads in any language.
Read post →JWT authentication uses signed tokens so servers verify identity without sessions. Learn the header-payload-signature structure and best practices.
Read post →Linux file permissions explained: reading ls -l output, octal vs symbolic chmod, ownership, setuid/setgid, and safe defaults for keys and web roots.
Read post →OAuth2 grant types compared: authorization code, PKCE, client credentials, device flow, and implicit. Pick the right flow for your app type.
Read post →Regex cheat sheet for developers: character classes, quantifiers, anchors, groups, and reusable patterns for email, URLs, dates, and logs.
Read post →REST API status codes explained: when to return 200, 201, 204, 400, 401, 403, 404, 409, 422, and 500, with a rule for each case.
Read post →Sorting algorithms compared simply: quicksort vs mergesort vs heapsort, when O(n2) sorts are fine, and what your standard library uses.
Read post →SQL indexes speed up queries by letting the database find rows without scanning tables. Learn B-tree basics, when to index, and common pitfalls.
Read post →TCP vs UDP explained: reliability vs speed, headers, handshakes, and use cases — plus a checklist for picking the right protocol.
Read post →Twelve-factor config with environment variables: separate config from code, naming rules, secrets handling, defaults, and fail-fast validation.
Read post →UTF-8 explained: how character encodings map bytes to text, why UTF-8 won over ASCII and Latin-1, and how to fix mojibake.
Read post →YAML gotchas that break config files: tabs, unquoted strings, the Norway problem, anchors, multiline scalars, and how to avoid each one.
Read post →One giant JSON file is easy to publish and hard to use. A catalog gives every dataset a stable URL, a readable page, and a fetch you can cache on its own.
Read post →HTTP status codes cheat sheet: the 13 codes that matter (200, 301, 404, 429, 503...), 401 vs 403 explained, plus a fetchable API dataset.
Read post →Bytes are exact and free to measure. Tokens are a model-specific estimate. Context is a budget you spend. A short primer on why the distinction matters.
Read post →HTTP methods reference: GET, POST, PUT, PATCH, DELETE safety and idempotency table, PUT vs PATCH explained, plus a fetchable API dataset.
Read post →CC0 data needs no attribution, so why cite it? Because a citation is how the next person finds the source when a number looks wrong. A practical format.
Read post →SQL join types explained: INNER, LEFT, RIGHT, FULL OUTER, CROSS, and SELF JOIN with syntax, which rows survive, and a fetchable dataset.
Read post →Git commands cheat sheet: the 15 essential commands (clone, add, commit, branch, merge, rebase, stash, reset) with exactly what each does.
Read post →Unix file commands cheat sheet: ls, find, grep, awk, sed, tar with examples, how they compose in pipes, plus a fetchable dataset.
Read post →LLM glossary: 8 key terms explained (tokens, context window, temperature, RAG, fine-tuning, quantization, KV cache, emergence) + fetchable dataset.
Read post →Cognitive biases decision checklist: 7 biases (confirmation, anchoring, sunk cost...) with a counter-move for each, plus a fetchable dataset.
Read post →Common network ports reference: 21, 22, 53, 80, 443, 3306, 5432, 6379, 8080, 27017 explained, plus how to read connection refused + dataset.
Read post →Grounding only helps if you verify the result. A practical loop: extract each claim, look it up in the dataset, compare exactly, and fail loudly on a mismatch.
Read post →Preloading a dataset into context wastes budget on rows the agent never reads. The lookup-first pattern fetches only the rows a task needs. Here is how it works.
Read post →How YJTOON stays free: open CC0 data funded by a paid ebook companion, and why selling synthesis beats paywalling facts.
Read post →A worked example: the same TCP/IP dataset in JSON (847 bytes) vs TOON (464 bytes), and how to switch formats per request.
Read post →Why public, free, and open datasets — not just algorithms and compute — will decide what AGI becomes, and what builders should do about it.
Read post →How YJTOON serves 185 datasets from a shared hosting plan: SQLite in WAL mode, IP-hash rate limiting, pre-generated static files, and no authentication.
Read post →How prompt caching works with long reference data: keep stable data in a stable prefix, put variable content after it, and treat format consistency as a cache key.
Read post →The llms.txt convention in plain terms: a simple text file at the site root that tells LLMs what the site offers and which URLs matter. How YJTOON uses it.
Read post →What public-domain dedication (CC0) means for consumers of YJTOON data, what attribution obligations remain, and how to license reference data cleanly.
Read post →The silent failure modes in reference data: unit names, timestamp formats, and character encodings. How YJTOON keeps them unambiguous and what consumers should check.
Read post →What the YJTOON search endpoint does (minimum 2 characters, LIKE across fields, 50-result cap) and the design choices that make search usable by agents.
Read post →Why every dataset needs a stable slug and canonical URL: caching, deduplication, versioning, and how agents should reference data they found earlier.
Read post →A practical comparison of CSV, JSON, and TOON for reference datasets: token cost, parseability, nesting, and when each format is the right choice.
Read post →How rate limiting actually works on YJTOON (120 requests per minute, escalating cooldowns) and the retry patterns agents should use when they hit a 429.
Read post →Why the Content-Type header matters for data APIs, what YJTOON serves for each format, and how agents and browsers interpret those headers.
Read post →A tour of the YJTOON catalog: 27 categories and 185 datasets spanning programming, HTTP, math, science, history, and more. How the catalog is organized and how to browse it efficiently.
Read post →A practical checklist for making a public data API easy for LLM agents: stable URLs, content negotiation, clear errors, rate-limit headers, and static fallbacks.
Read post →Why RSS is still the right feed format for technical blogs, and the small set of fields a developer should validate before subscribing.
Read post →The minimum set of Open Graph and Twitter Card tags a technical blog post needs, why each one matters, and the easy mistakes to avoid.
Read post →Why every developer should ship a small, personal knowledge API for their own use, and the minimum features it needs to be useful to an agent.
Read post →Static reference files fronted by a CDN are a cheap cache for LLM context. Here is when to reach for them and how to keep them fresh.
Read post →Tags help both humans and agents find related material. Here is the small, opinionated tag set YJTOON uses, with rules for when to add a new tag.
Read post →A short decision guide for picking between the YJTOON REST API, the static file tree, and the inline JSON snippet, based on latency, freshness, and reuse.
Read post →The exact 7-step workflow we use to take a blog post from a blank JSON file to a live URL on the CDN. With the failure modes and the rollback.
Read post →How YJTOON picks between JSON, YAML, and TOON based on the Accept header, and how to override it without changing your client library.
Read post →Practical rules for shaping reference datasets so they are useful to humans and to LLM agents: naming, units, ranges, ambiguity, and provenance.
Read post →How to make agents robust to API failures without overcomplicating them. Includes retry, backoff, circuit-breakers, and graceful degradation.
Read post →Patterns for keeping an agent responsive when a reference API is slow. Includes cached fallbacks, partial answers, and honest errors.
Read post →How TOON handles nesting: objects by indentation, arrays by length-prefixed headers, uniform nested objects folded into table headers, and when it falls back to list form.
Read post →A guided tour of one of the most-used YJTOON datasets: HTTP status codes. What is in it, what is not, and how to extend it.
Read post →A short, opinionated SEO checklist for technical blog posts. No fluff, no SEO-speak. The minimum that actually moves rankings.
Read post →How to attribute open data sources in derived datasets and in LLM prompts. A short set of rules and the small set of edge cases that trip people up.
Read post →How to structure reference material in system prompts so models actually use it. Covers placement, length budgets, attribution, and a few anti-patterns to avoid.
Read post →A copy-paste template for the "reference card" pattern in system prompts, with annotated examples and the small set of fields that actually help.
Read post →A short checklist for keeping a sitemap.xml honest on a small site: which URLs to include, how to set lastmod, and how to avoid the common traps.
Read post →YJTOON serves the same data two ways: a REST API and a CDN-fronted static file tree. Here is a decision guide with examples.
Read post →When to force JSON-schema output and when to let the model answer in prose. A short decision guide with failure examples.
Read post →How many tokens does pretty-printed JSON waste in a prompt? We measured three common styles and a couple of fixes.
Read post →A working TOON parser in 83 lines of Python: objects, inline arrays, tabular rows, list items, and quoting. Round-trips all 185 YJTOON datasets exactly.
Read post →A simple budgeting method for prompts that combine instructions, several reference documents, and a question. Includes a worked example.
Read post →TOON is best understood as a prompt compression format, not a storage format. This reframe changes how you think about when to reach for it.
Read post →A short tour of TOON encoder edge cases: empty cells, embedded newlines, numeric precision, and the rules for escaping safely.
Read post →How TOON writes objects, arrays, tables, and strings: the four array forms, quoting rules, and number handling, with real output from the YJTOON encoder.
Read post →Real token counts for all 185 YJTOON datasets in JSON, minified JSON, YAML, and TOON: 19% fewer tokens than minified JSON on table-shaped data, slightly more on list-shaped data.
Read post →A reference for the rate-limit headers YJTOON returns, what each one means, and how to use them without guessing.
Read post →Practical patterns for checking model answers against a small reference dataset, with code snippets and a discussion of common failure modes.
Read post →How to evolve a public dataset over time without forcing every consumer to re-sync. A small set of rules learned from production.
Read post →Vector databases are the default answer for "AI search." Most of the time they are the wrong default. Here is when to reach for something simpler.
Read post →Reasoning behind YJTOON's code-only, no-admin-UI blog: durability, agent-friendliness, and the smallest surface that still works.
Read post →Reasoning behind YJTOON's no-authentication, no-signup design and the small set of protections that make it work in practice.
Read post →Practical guide to YJTOON rate limits, the 429 response shape, and the recommended request patterns for agents and CI pipelines.
Read post →How to request YJTOON datasets in TOON format and include them in prompts with minimal token overhead. Includes practical examples and tips for agents.
Read post →YJTOON provides free, structured reference datasets in JSON, YAML, and token-efficient TOON. Designed for quick human lookup and efficient LLM consumption. No signup, no limits beyond fair use.
Read post →