{
 "schema_version": 1,
 "generated": "2026-10-23",
 "id": "oxynote-oxynote--flag-stale-docs-with-freshness-hooks",
 "repo": "oxynote/oxynote",
 "repo_url": "https://github.com/oxynote/oxynote",
 "repo_slug": "oxynote-oxynote",
 "title": "Get reminded when a runbook's source changes",
 "page_title": "How to get reminded when a runbook's source changes with Oxynote",
 "summary": "Attach freshness hooks to a page so its maintainers hear about changes to the files or images it depends on.",
 "who": "A platform engineer who keeps deployment docs tied to a GitHub repo or a container image and wants to know when they fall out of date.",
 "problem": "Docs describing a deployment go stale silently after the code or image changes.",
 "outcome": "A page that tracks a GitHub file, container image, web page or date, and reminds its maintainers when that dependency changes.",
 "steps": [
  "Run `docker run -d --name oxynote -p 8080:8080 -v oxynote_data:/oxynote/data ghcr.io/oxynote/oxynote:latest` (join the lines into one command). (inferred, check the README)",
  "Open http://localhost:8080 and log in, then connect the GitHub app for the workspace.",
  "Open the page or block that describes the deployment and add a freshness hook. (inferred, check the README)",
  "Set the hook to a GitHub file, container image, web page or date that the page depends on.",
  "Confirm that the page maintainers are set so that they get the reminder."
 ],
 "agent_prompt": "Using the oxynote/oxynote repo at <oxynote-url>, add a freshness hook to the page <page-title> that tracks <github-file-or-image>. Expected output: the hook name and its target. Verify that the page shows the tracked dependency and that the maintainers are listed.",
 "agents": [
  "any"
 ],
 "difficulty": "Intermediate",
 "time": "30 minutes",
 "basis": "readme",
 "caveat": "The README lists freshness hooks but does not say how reminders are delivered beyond maintainers getting one, so test the notification path before relying on it.",
 "category": "Software and DevOps",
 "tags": [
  "Software and DevOps"
 ],
 "lang": "go",
 "requirements": [
  "Docker installed, with port 8080 free on the host",
  "A Prometheus server or a PostgreSQL, MySQL or MariaDB database to query for live metric blocks",
  "The default login from the README (admin@example.com) changed before any real data goes in",
  "For agent access: Claude Code or Codex installed, able to use MCP over OAuth"
 ],
 "risk": "sensitive",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [],
 "best": false,
 "score": 0.7,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/oxynote-oxynote/flag-stale-docs-with-freshness-hooks/",
 "md": "https://dedupedai.com/use-cases/oxynote-oxynote/flag-stale-docs-with-freshness-hooks/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/oxynote-oxynote--flag-stale-docs-with-freshness-hooks.json",
 "api_version": "v1"
}