Glossary

Plain-language definitions for the words that get thrown around on a build. Written for the people I work with, not for other developers.

"Code Concepts":

"A defined way for two pieces of software to talk to each other. Think of it as a menu: the other system publishes what it can do, and you order from that list instead of reaching into its kitchen.",

"Continuous integration and continuous deployment. Automation that tests every change and, once it passes, ships it. It turns releases from an event into a routine.",

"Laravel's object-relational mapper: each database table gets a model class you query and write through, instead of hand-writing SQL.",

"A setting kept outside the code, like a database password or an API key. It lets the same application run on a laptop and in production without edits, and keeps secrets out of version control.",

"Version control. Every change is recorded with an author and a reason, branches let work happen in parallel, and anything can be traced back or undone.",

"A framework for building reactive interfaces in PHP. The component re-renders on the server and swaps the changed HTML into the page, so there is no separate JavaScript app to maintain.",

"A versioned, reversible description of a schema change. Running them in order builds the same database on every machine.",

"Model, View, Controller. A way of splitting an application into the data, the presentation, and the logic that connects them, so changing one does not force you to rewrite the others.",

"A standard format for describing what an API does, written so both people and machines can read it. Documentation, test tools, and client code can all be generated from one spec file.",

"Rewriting code so it is easier to work with, without changing what it does. Nothing new appears on screen, but the next change gets cheaper.",

"Something that used to work and now does not, usually broken by an unrelated change. Automated tests exist mostly to catch these before anyone else does.",

"A common set of conventions for building APIs over the web. Predictable addresses, standard verbs for reading and writing, and no memory of your last request.",

"A copy of the live site used for final checks. Same code, same setup, real-looking data, no real customers watching.",

"The future cost of a shortcut taken today. Sometimes worth borrowing to hit a deadline, as long as everyone agrees it is a loan and not a gift.",

"A reversed API call. Instead of you asking another system for news every few minutes, it calls you the moment something happens.",

"Working With Clients":

"Writing down a change to the agreed work along with what it costs in money and time. The cure for scope creep, and far easier to raise early than late.",

"The conversation before the work, where you find out what the client actually needs rather than what they first described. Skipping it is the most expensive time you will ever save.",

"Pulling in more help or authority because the current path is not resolving the issue. Done early it is good judgment. Done late it is an apology.",

"Passing work to another person or team along with the context they need. A handoff without the context is just a transfer of confusion.",

"Everything between signing and the client genuinely using the thing. Technically it is setup and training. Practically it is where trust is either built or lost.",

"A review after something went wrong, focused on what in the process allowed it rather than who to blame. Useful only if people can speak freely.",

"Turning "we need this to be easier" into something specific enough to build and testable enough to confirm when it is done.",

"The actual reason something broke, as opposed to the symptom that got reported. Fix the symptom and it comes back next week wearing a different hat.",

"A project quietly growing past what was agreed, usually one small reasonable request at a time. Nobody notices until the deadline does.",

"Anyone affected by the outcome. The person paying for it, the team that will use it daily, and the one who only appears at the end are all stakeholders, and they rarely want the same thing.",

"Languages":

"The styling layer. Colors, spacing, typography, and layout all live here, separate from the content so either can change without breaking the other.",

"The structure of a web page. It says what things are: a heading, a paragraph, a link. It says nothing about how they look.",

"The language that runs inside your browser. If something on a page moves, updates, or responds without reloading, JavaScript is usually behind it.",

"The language most of the web is quietly built on, including this site. It runs on the server, assembles the page, and sends it to your browser.",

"A language designed to be pleasant to read, most often seen with the Rails framework. Optimized for the developer rather than the machine.",

"The language used to ask a database questions. "Give me every order from last March over five hundred dollars" is one query away.",