Glossary
Common terms used throughout this documentation and the codebase.
Technical Terms
- Astro
- The static site generator used to build this website. Astro compiles markdown and components into static HTML at build time. astro.build
- Build Time
- When the site is compiled from source files into deployable HTML. Changes to content require a rebuild to appear on the live site. Contrast with "runtime" (when a visitor views the page).
- Collection
- A group of related content files (e.g., articles, events, docs). Each collection has a schema that validates frontmatter. See Schema Reference.
- Frontmatter
-
The metadata block at the top of a markdown file, enclosed in triple dashes (
---). Contains structured data like title, date, and tags.--- title: "My Article" date: 2026-01-15 tags: ["example"] --- - IANA Timezone
-
A standardized timezone identifier like
America/Los_AngelesorAmerica/New_York. Used instead of abbreviations (PST, EST) because those are ambiguous. Full list - Layout
- An Astro component that wraps page content, providing consistent structure (header, footer, navigation). Pages specify their layout in frontmatter or imports.
- Markdown
-
A lightweight markup language for formatting text. Files use the
.mdextension. Supports headings, lists, links, code blocks, and more. Syntax guide - Pull Request
- A proposed change submitted through GitHub. Contributors create a branch, make changes, then request that those changes be "pulled" into the main codebase. Abbreviated as PR. See Pull Requests.
- Schema
-
A definition of the structure and types for frontmatter fields. Defined using Zod in
src/content/config.ts. Invalid frontmatter causes build failures with helpful error messages. - Slug
-
The URL-friendly identifier for a page, derived from the filename or folder name. For
example,
2026-01-january-meetingbecomes the URL/events/2026-01-january-meeting.- Use lowercase
- Use hyphens instead of spaces
- Avoid special characters
- Keep it short but descriptive
- Static Site
- A website where all pages are pre-built as HTML files at build time, rather than generated on each request. Results in fast load times and simple hosting (like GitHub Pages).
- View Transitions
- A browser feature that animates between page navigations, making the site feel like a single-page application. Astro enables this with client-side routing while preserving the benefits of static pages.
- YAML
-
The format used for frontmatter. Uses indentation for structure and colons for key-value
pairs.
title: "Example" tags: - one - two nested: key: value - Zod
- A TypeScript-first schema validation library. Used to define and validate frontmatter schemas. Provides helpful error messages when content doesn't match the expected structure. zod.dev
Acronyms
- API
- Application Programming Interface. A set of functions that allow programs to interact with each other. In this context, usually refers to VS Code's extension API or Astro's content API.
- CI
- Continuous Integration. Automated processes that run when code is pushed, including builds, tests, and deployments. GitHub Actions runs our CI pipeline.
- CSS
- Cascading Style Sheets. The language used to style web pages—colors, fonts, spacing, and layout. This site uses CSS custom properties (variables) for consistent design tokens.
- DPI
- Dots Per Inch. A measure of display resolution. High-DPI displays (Retina, 4K) pack more pixels, requiring larger source images to appear sharp.
- DST
-
Daylight Saving Time. The practice of advancing clocks during summer. IANA timezones handle
DST automatically—
America/Los_Angelesis PST in winter and PDT in summer. - E2E
- End-to-End testing. Tests that simulate real user interactions with the full application. This site uses Playwright for E2E tests.
- HTML
- HyperText Markup Language. The standard language for web page structure. Astro compiles markdown and components into HTML at build time.
- JSON
-
JavaScript Object Notation. A data format using key-value pairs and arrays. Used for
configuration files like
package.jsonand search indexes. - PR
- Pull Request. See Pull Request.
- SEO
- Search Engine Optimization. Practices that help content appear in search results. Includes descriptive titles, meta descriptions, and semantic HTML.
- SVG
- Scalable Vector Graphics. An image format using mathematical shapes rather than pixels. SVGs scale perfectly to any size and work well for icons, logos, and diagrams.
- UTC
- Coordinated Universal Time. The primary time standard by which the world regulates clocks. Amateur radio often uses UTC for logging contacts and contest times. Equivalent to GMT (Greenwich Mean Time).
- WebP
- A modern image format developed by Google. Offers better compression than JPEG and PNG while maintaining quality. Astro automatically converts images to WebP at build time.