Skip to content
J·BJon BishopIndependent growth marketer

READMEs · Product analytics

PostHog README

A broad product README with a clear cloud recommendation, an advanced self-hosting route and an explicit open-source-versus-paid section.

Reviewed 2026-09-30View reviewed source ↗

The README, with notes

See how the pieces fit.

Three things worth borrowing from this README. Follow the notes beside the image, then use the ideas in your own.

PostHog / README.mdCapture 2026-10-14 · View on GitHub ↗
PostHog README at the reviewed commit. This image section shows product introduction.
Product introduction

01 Product introduction

Turn the feature list into useful routes.

The introduction links product capabilities to separate pages and describes multiple ways to access the platform.

Try this in yours

Link each capability to an explanation or a working example. If your product solves one main problem, lead with that job before expanding the list.

PostHog README at the reviewed commit. This image section shows getting started.
Getting started

02 Getting started

Recommend a route. Explain the alternative.

Cloud is marked recommended; hobby self-hosting is labeled advanced, with deployment constraints and support disclaimers.

Try this in yours

Put the easiest starting point first. Keep deployment effort, maintenance and support expectations beside the self-hosted option.

PostHog README at the reviewed commit. This image section shows open-source vs. paid.
Open-source vs. paid

03 Open-source vs. paid

Make the edition boundaries visible.

A separate section describes the core license and the enterprise directory exception.

Try this in yours

Explain which code is open source and where paid features begin. Help someone evaluating the product understand the scope before they invest in setup.

Prefer to write? Send Jon a message.