ouo11y.com

The ouo11y website: landing page, docs, blog, newsletter and announcements. Astro with Starlight for the docs, deployed to GitHub Pages by .github/workflows/deploy.yml on every push to main.

npm install

npm run dev        # http://localhost:4321, drafts included

npm run build      # dist/, what Pages serves

Where things live

Path	What
src/pages/index.astro	the landing page
src/content/docs/docs/	docs pages (Starlight), served under /docs/; the sidebar is in astro.config.mjs
src/content/blog/	know-how, tips and tricks
src/content/newsletter/	the monthly o11y radar: OpenTelemetry and vendor news, every item with a source link
src/content/announcements/	ouo11y releases and news
src/lib/site.ts	site name, contact emails, section blurbs
public/CNAME	the custom domain, ouo11y.com

Write a post

Add a Markdown file to blog/, newsletter/ or announcements/ under src/content/. The file name is the URL slug.

---
title: "Tip: redact once, at the collector"
description: One sentence for the list page, RSS and link previews.
date: 2026-11-02
tags: [collector, tips]
draft: true        # shown by `npm run dev`, left out of the build; remove to publish
---

Each section has an RSS feed at /<section>/rss.xml.

Rules for content

• Every news item in the newsletter links to its primary source. No unsourced claims.
• Use OpenTelemetry names; an ouo. attribute is described as waiting for an OTel convention.
• Write ouo11y lowercase, always.