PostHog Handbook Library

The generated reader is not manually maintained. It rebuilds from PostHog's public handbook source.

const SOURCE_REPO = "PostHog/posthog.com";
const TREE_API =
  "https://api.github.com/repos/PostHog/posthog.com/git/trees/master?recursive=1";

const handbookFiles = tree
  .filter((file) => file.path.startsWith("contents/handbook/"))
  .filter((file) => file.path.endsWith(".md") || file.path.endsWith(".mdx"));

Every edition gets source links and a generated date so readers know exactly what they are holding.

const manifest = {
  generatedAt: today(),
  sourceRepo: "PostHog/posthog.com",
  sourceRef: "master",
  pages: pages.map((page) => ({
    title: page.title,
    sourceUrl: githubUrl(page.sourcePath),
    hash: hash(page.content),
  })),
};

The point is not just downloadability. It shows what changed since the prior generated release.

const changes = diffManifests(previousManifest, currentManifest);

await writeFile("dist/latest/changes.md", renderMarkdownDigest(changes));
await writeFile("dist/latest/changes.json", JSON.stringify(changes, null, 2));