The Guide

"A menu at a restaurant. You don't go into the kitchen — you just order what you want and it shows up."

APIs let software talk to other software. When Claude Code reads your files or runs commands, it's using APIs. When your website pulls content from Sanity, that's an API call too. You don't need to understand the kitchen — you just need to know what's on the menu.

"When AI stops waiting for instructions and starts making its own to-do list."

An agentic AI doesn't just answer questions — it breaks tasks into steps, uses tools, and works through problems autonomously. Think: the difference between a calculator and an assistant. Claude Code is agentic. ChatGPT in a text box is not.

"When developers say 'build' they mean turning human-readable code into computer-readable code. Like translating a recipe into microwave instructions."

A build step transforms your source code into something a browser or server can actually run. Modern sites often have a build process that compiles templates, optimizes images, and bundles JavaScript. When you run npm run build, that's what's happening. If the build fails, nothing deploys.

"A chain of photocopiers strategically placed around the world so nobody has to wait."

Content Delivery Network. Instead of serving your website from one computer in Virginia, a CDN copies it to servers everywhere. When someone in Singapore loads your site, they get the copy from Singapore, not Virginia. Sanity uses one. Cloudflare is one.

"MS-DOS. But voluntarily."

Command Line Interface. A text-only way to talk to your computer. You type commands, it does things. No buttons, no menus. Terrifying at first, liberating once you realize it's just typing sentences to a very literal machine.

"Tiny programs that live on the internet's edge and do one thing really fast."

Serverless functions that run on Cloudflare's global network. They're fast because they run close to the user, not in a data center on another continent. THE SYLLABI runs on one.

"Hitting 'publish' but for code."

Taking your website or app from your computer and putting it on the internet where people can see it. The anxiety you feel right before clicking deploy is universal and never goes away.

"Running code in the city where your user lives, not in a data center on another continent."

Instead of sending every request to a single server farm in Oregon, edge computing distributes your code to servers all over the world. The result: faster load times, lower latency, and happier users. Cloudflare Workers are edge computing. The "edge" is just "closer to the person asking."

"Teaching a general-purpose genius to be really good at your specific weird thing."

Taking a pre-trained AI model and training it further on your own data so it gets better at your particular use case. Like hiring a brilliant generalist and then putting them through industry-specific onboarding.

"SQL's cooler, younger cousin who only hangs out with Sanity."

A query language for getting data out of Sanity. Instead of clicking through a database interface, you write short queries like *[_type == "article"] and get exactly what you asked for. It's genuinely fun once you get past the first 20 minutes.

"When AI confidently makes things up. Like your colleague in the strategy meeting."

AI models sometimes generate plausible-sounding but completely false information. They don't know they're wrong. They can't know they're wrong. This is the single most important thing to understand about AI.

"A text editor that got really ambitious. Like Notepad with a PhD."

Integrated Development Environment. A program where you write code, but with built-in superpowers: syntax highlighting, error detection, auto-complete, debugging tools, and a terminal. VS Code is the most popular one. Cursor is an AI-powered fork of it. You can write code in Notepad. You just really shouldn't.

"The language computers use to pass notes to each other. Looks scary, is actually just labeled boxes inside labeled boxes."

JavaScript Object Notation. A format for structuring data that both humans and machines can read. Every API you'll encounter speaks JSON. It looks like this: {"name": "The Syllabi", "panic": false}. Curly braces, colons, quotes. Once you see the pattern, you'll spot it everywhere.

"A password that lets software talk to other software. Treat it like your house key — don't post it on Twitter."

A unique string of characters that identifies your application and grants it access to an API. Every service you connect to — Sanity, OpenAI, Cloudflare — gives you an API key. Leak it publicly and strangers can run up your bill or access your data. Store it in environment variables, never in your code.

"A very well-read parrot that somehow also understands what it's saying. Mostly."

Large Language Model. The technology behind ChatGPT, Claude, and friends. Trained on enormous amounts of text, these models predict what comes next in a sequence. The fact that this produces intelligence is either a profound insight about language or a terrifying accident. The jury's out.

"Like API, but for AI assistants specifically."

Model Context Protocol. A standard that lets AI models connect to external tools and data sources. Before MCP, every AI integration was custom-built. MCP is the USB-C of AI tooling — one standard to connect everything.

"How you write formatting when you can't click Bold."

A simple syntax for formatting text. **bold** becomes bold, # Title becomes a heading. Programmers love it. Normal people find it weird for about five minutes and then wonder why Word exists.

"JavaScript that escaped the browser and now runs everywhere. The lingua franca of web tooling."

A runtime that lets you run JavaScript outside a web browser — on servers, in build tools, on your laptop. If you've ever run npm install, you're using Node. Most modern web development tools are built on it, which is why installing anything eventually requires it.

"Software you can read, copy, and modify. Like a recipe posted publicly instead of kept secret."

Open-source software makes its code available for anyone to inspect, use, and improve. Linux, VS Code, Astro, and most of the tools mentioned in this guide are open source. It's how the internet was built, and it's the reason a solo founder can use world-class tools for free.

"The thing you type into an AI. Also the single biggest determinant of whether you get genius or garbage."

A prompt is the input you give an AI model. It can be a simple question, a detailed brief, or a carefully structured set of instructions. Prompt engineering — the art of writing good prompts — is a real skill. The difference between a vague prompt and a specific one is the difference between "write me something" and "write me a 200-word intro for non-technical founders explaining what an API is, in a witty tone."

"A polite way of saying 'I changed some code, please look at it before we use it.'"

A pull request is a proposal to merge code changes from one branch into another. It's a review process: you show what you changed, someone looks at it, and then it either gets approved or you go back and fix things. Even solo developers open PRs to keep a clean record of what changed and why.

"A question you ask a database. GROQ is a query language. SQL is a query language. Google is a query language if you squint."

A query is a structured request for data. Instead of scrolling through a spreadsheet, you write a query that says "give me all articles published after January, sorted by date." Different systems use different query languages — GROQ for Sanity, SQL for traditional databases, GraphQL for many APIs — but the concept is always the same: ask precisely, get precisely.

"A folder of code that Git tracks. Lives on GitHub. Contains your project, your history, and your mistakes."

A repository is a project directory that's being tracked by version control. It stores every file, every change, and every commit message. Public repos let anyone see your code. Private repos keep it locked down. If you're building something, you have a repo. If you don't, you should.

"A tool that builds your entire website ahead of time so servers don't have to think. Astro is one."

A static site generator takes your content and templates and pre-builds every page as plain HTML files. No database queries at runtime, no server-side rendering on each visit. The result is blindingly fast and dirt cheap to host. Astro, Hugo, and Eleventy are popular SSGs. THE SYLLABI is built with one.

"A blueprint that tells your CMS what shape your content should be. Like defining columns in a spreadsheet before filling in rows."

A schema defines the structure of your data: what fields exist, what types they are, which ones are required. In Sanity, you write schemas in code to describe your content models — articles have titles (string), bodies (rich text), and authors (reference). Without a schema, your data is just a pile of stuff.

"The atomic unit of text that AI models think in. Not words, not characters — tokens. 'Don't Panic' is two tokens. Your API bill is counted in them."

Tokens are chunks of text that language models process. A token might be a word, part of a word, or a punctuation mark. "Unbelievable" might be three tokens: "un", "believ", "able". Models have token limits (context windows) that determine how much text they can consider at once. More tokens = more cost, more context, more capability.

"The text-based window where you type commands. See: CLI."

The application on your computer that provides a command line interface. On Mac it's literally called Terminal. On Windows it's PowerShell or Command Prompt. It's where you run Git commands, install packages, start dev servers, and feel like a hacker in a movie. Every developer has one open at all times.

"The part of software that humans actually see and touch. Everything else is plumbing."

The buttons, forms, layouts, colors, and typography that make up the visual layer of an application. When someone says "the UI is clean," they mean it looks good and makes sense. When they say "the UI is confusing," they mean someone skipped the design step. UI is what your users judge you on, regardless of how elegant the code underneath is.

"A system for tracking every change ever made to your code. Like infinite undo, but for your entire project. See: Git."

Version control records what changed, who changed it, and when. If something breaks, you can rewind. If two people edit the same file, it helps you merge their work. Git is the dominant version control system. GitHub is where Git repos live online. Using version control is not optional — it's the seatbelt of software development.

"An automated phone call between servers. 'Hey, something changed' — that's a webhook."

A webhook is a way for one service to notify another when something happens. Publish an article in Sanity? A webhook can tell Cloudflare to rebuild your site. Someone pushes code to GitHub? A webhook can trigger a deploy. It's event-driven automation — instead of constantly asking "anything new?", the system tells you.

"See: Cloudflare Workers. A tiny serverless function at the edge."

In the context of this site, a Worker means a Cloudflare Worker — a small JavaScript function that runs on Cloudflare's global network, handling requests close to where users actually are. Workers are fast, cheap, and scale automatically. No server to manage, no infrastructure to maintain.

"A configuration format that uses indentation instead of brackets. Looks clean until you get the spacing wrong and everything breaks."

YAML Ain't Markup Language (yes, it's a recursive acronym). A human-readable format used for configuration files, CI/CD pipelines, and deployment settings. Unlike JSON, it uses whitespace instead of braces, which makes it pleasant to read and infuriating to debug. One wrong indent and your entire deploy pipeline fails silently.