PostHog Handbook Library / Wizard And Docs

1,094 words. Estimated reading time: 5 min.

Learn platform

Why Learn exists

There's a gap between what PostHog can do and what people know what to do with it. And it's growing.

The goal of the Learn platform is to teach _humans_ how to use PostHog well.

Yes, Learn content is educational content specifically made for _humans_. It is not content written for agents, _but_ it can be fed to an agent, if a human uses agents as their go-to tool. It's just not to be confused with agent food.

But what does "use PostHog well" mean? It means humans:

In the end, if someone can do these things, we've accomplished our jobs as educators. And it's proof that we have _real_ power users in the wild.

How humans learn

Since Learn content is written for humans, there's two things at play: humans all learn well differently, and how humans learn has changed in the AI-age.

More importantly, the humans we write for are product engineers, founders, and builders, so our entire Learn strategy is focused on these learners.

In general, humans learn in a bunch of different ways. We won't try to cover _all_ of them, because we care most about our ICP. We're betting that our ICP learns in the following ways:

Learn content types

To satisfy different preferences in learning, we have different content types.

Learn with an agent

This content type is best for learners who like to use agents as a learning tool. The first iteration of this learning type is a prompt they can hand their coding agent that:

An example of this is available today on the Product Analytics Learn page.

We plan to add more here.

Learn with a story

This content type is best for learners who prefer to read. Yes, there are still humans who read, literary crisis and all.

Our pocket guides are written like stories and they follow a product question from "what's going on" to "what should I build next?". They show product decisions made along the way, the data behind those decisions, and end in an action the reader can take.

Learn by doing

This content type is best for learners who like to tinker.

Twig is a working example product with PostHog already instrumented. Learners can click around, inspect its data, and complete Labs in its embedded Playground.

How to contribute

Learn is a platform that all PostHoggers can contribute to. If you have a question customers keep asking, a useful example, a story, or an exercise that you think would be helpful – we want to make sure you can share it with our learners!

In general, to contribute to learn content:

  1. Start with what you want the learned to understand or do. Make this clear from the beginning.
  2. Choose a format that teaches it best: with an agent, pocket guide, or Twig. If you have a new format, open a docs request issue and pitch it to us!
  3. Start writing. Use existing examples and components where you can, so we aren't rebuilding the same lessons in different places.
  4. Get feedback from the relevant product team to check that it teaches the product accurately.

We're here to help shape the experience if you feel stuck along the way. Ask us in #team-wizard-and-docs.

We also have more specific guides if you are interested in writing a pocket guide or adding Twig components:

Visibility and distribution

In the before times, learning was a byproduct of a human _doing_ a task: reading, testing something, building. Learning happened naturally when someone did a task because they learned skills they needed to complete the task.

In the now times, humans are doing less tasks, and they're passing on the work to agents. This doesn't mean it's over for education, it just means they have less chances to learn by doing.

If we don't make it easy for them to choose to learn, they simply won't learn – and the education deficit gets worse. To make it easy for them to seek it out, we need good visibility and distribution.

Visibility

To increase awareness of learn content, we need visibility! Learners won't know it exists if they can't physically _see_ it anywhere on the website or in the product. To increase visibility:

Distribution

Distribution is treated like an ongoing project, so this section is subject to change as we add other distribution ideas.

| Channel | Plans | Status | |---|---|---| | X | Threads that contain pared-down versions of pocket guides, with a link to the pocket guide at the end for the full version | Planning | | Paid ads | Paid ads campaign with pocket guide covers | Planning | | Community | Book club – regular meetings in Discord to discuss pocket guides, with guided discussion topics | Planning | | Blog | "Docs are dead" blog post | Idea | | IRL | Print out physical copies of pocket guides for HogPatch | Idea | | Video shorts | 30s video shorts – pocket guide teasers | Idea |

Feedback

We want people to _love_ learn content, so we need feedback. Currently we have workflows to ask for feedback from pocket guide readers. Other planned feedback strategies include:

Canonical URL: https://posthog.com/handbook/wizard-and-docs/learn

GitHub source: contents/handbook/wizard-and-docs/learn.mdx

Content hash: 674f26b5f398d4d0

Static reader notes
  • MDX_COMPONENT_STATIC_ADAPTER: Adapted interactive MDX components for static reading: PrivateLink, ProductScreenshot.