Glossary
The vocabulary of website feedback, bug reporting, and issue-tracker integrations — defined properly, with the reason each one matters.
Website feedback widget
A small on-page control that lets visitors report problems or suggest changes without leaving the page.
Feedback loop
The full cycle from a user noticing a problem to that problem being fixed and the user knowing about it.
Bug report
A structured description of unexpected software behaviour, complete enough for someone else to reproduce it.
Severity triage
Sorting incoming reports by how much damage each one is doing, so the worst thing in the queue is the first thing you see.
Steps to reproduce
The ordered list of actions that reliably triggers a bug.
Issue tracker
The system of record where engineering work is queued, assigned, and closed — GitHub Issues, Jira, Linear.
GitHub Issues
GitHub's built-in issue tracker, living alongside the code in the same repository.
Jira ticket
A work item in Atlassian Jira, typed and governed by a configurable workflow.
Atlassian Document Format (ADF)
The structured JSON document model Atlassian Cloud APIs use for rich text instead of Markdown or HTML.
Fine-grained access token
A GitHub credential scoped to specific repositories and specific permissions, rather than to everything you can reach.
Principle of least privilege
Granting every component exactly the access it needs to do its job, and nothing beyond it.
Row level security (RLS)
A Postgres feature that filters which rows a role can see or change, enforced by the database rather than the application.
Multi-tenancy
One application instance serving many customers whose data must never mix.
Encryption at rest
Storing data in encrypted form so that access to the storage medium is not access to the data.
Idempotency key
A stable identifier that lets an operation be retried safely without producing a duplicate.
Webhook
An HTTP callback one system sends to another when something happens.
Session replay
Recording a visitor's interactions with a page and playing them back as video-like footage.
Screenshot capture
Turning what is on the page into a single still image attached to a report — which is a different thing from recording a session.
User-reported bug
A defect found by someone using the product rather than by a test, a monitor, or an engineer.
Shadow DOM
A browser feature that gives an element its own encapsulated DOM tree and style scope.
Content Security Policy (CSP)
An HTTP header telling the browser which sources of script, style, and other content are permitted on a page.
CORS
The browser mechanism that governs which origins may make cross-origin requests to an API, and read the response.