Dev Notes

ops

Developer Onboarding

Quick start steps to clone, install dependencies, and generate the site locally.... #onboarding#setup

Developer Onboarding

  1. Clone the repository and install Node 20+.
  2. Run npm install to pull dependencies.
  3. Build with npm run build; output lands in dist/.
  4. Serve dist/ via any static server (e.g., npx serve dist).

Directory overview

  • content/: Markdown notes with front matter.
  • templates/: HTML shells for header, footer, and layout.
  • assets/: CSS and JavaScript shared across pages.

Conventions

  • Use kebab-case filenames.
  • Keep summaries short; they populate listings and the search index.
  • Add tags to improve search results.