From ffbb414e43913e4cb63146f6c065d4561789541f Mon Sep 17 00:00:00 2001 From: Joe Martin <84011561+joethreepwood@users.noreply.github.com> Date: Tue, 21 Apr 2026 20:00:00 +0100 Subject: [PATCH 1/3] Graphics team updates --- contents/handbook/brand/art-requests.md | 2 +- contents/handbook/brand/overview.md | 6 +- .../engineering/product-design-process.md | 25 ++ .../handbook/engineering/product-design.md | 2 +- contents/handbook/marketing/index.md | 11 +- contents/handbook/marketing/ownership.md | 4 +- contents/handbook/wide-company.md | 2 +- src/navs/index.js | 334 +++++++++--------- vercel.json | 1 + 9 files changed, 215 insertions(+), 172 deletions(-) create mode 100644 contents/handbook/engineering/product-design-process.md diff --git a/contents/handbook/brand/art-requests.md b/contents/handbook/brand/art-requests.md index bedc703c0dec..8b16251a25d8 100644 --- a/contents/handbook/brand/art-requests.md +++ b/contents/handbook/brand/art-requests.md @@ -7,7 +7,7 @@ hideAnchor: false > 🎨 **Need artwork or merch?** Please request it using the [request templates](https://github.com/PostHog/posthog.com/issues/new/choose). Do not request art or merch over Slack or email. -All artwork and merch requests are handled by , , and on the team. +All artwork and merch requests are handled by , , and on the Graphics team. They can help you with things like: diff --git a/contents/handbook/brand/overview.md b/contents/handbook/brand/overview.md index fb738165e22a..48589d8b7b10 100644 --- a/contents/handbook/brand/overview.md +++ b/contents/handbook/brand/overview.md @@ -4,6 +4,8 @@ sidebar: Handbook showTitle: true --- -The focuses on design and the PostHog website. This includes writing the copy for pages outside of the docs and handbook. This is considered the source of truth for how we talk about our products. +The Graphics team focuses on creating all illustration and art work for PostHog. As the team responsible for PostHog's visual identity, they have the final say on all such matters, including in regards to brand. -We work closely with the and . +The Graphics team works closely with all teams at PostHog. + +This team does not own product design or website design, which are handled by the engineering teams and the respectively. diff --git a/contents/handbook/engineering/product-design-process.md b/contents/handbook/engineering/product-design-process.md new file mode 100644 index 000000000000..c0da4d328683 --- /dev/null +++ b/contents/handbook/engineering/product-design-process.md @@ -0,0 +1,25 @@ +--- +title: Product design process +sidebar: Handbook +showTitle: true +hideAnchor: false +--- + +## No product design within small teams + +We encourage engineers to act like feature owners, carrying a project from ideation to completion. We maintain a design system in [Storybook](https://storybook.dev.posthog.dev/), so engineers can build high-quality features independently, as much as possible. + +Because engineers choose their sprint tasks near the beginning of a sprint (and product doesn't plan tasks _for_ engineers in advance), our process doesn't allow for us to have a product manager and a designer to work closely together before a task gets selected by an engineer. + +In our process of short, 2-week sprints with no pre-planning, design would become a blocker to an engineer quickly iterating on a feature. Thus, engineers don't get support from product designers. Product designers should deliver high quality components. The product teams should have people in them that can ship good-enough quality interfaces using those components. If that's not true, we should hire or move people around. + +Learn more about how we decide this in our [guide to working with product designers, for engineers](/handbook/engineering/product-design). + + +## Requesting artwork and brand materials. + +Need some custom artwork? Read the [art and branding request guidelines](/handbook/brand/art-requests). + +## Portfolio + +You can find [PostHog's design portfolio](https://dribbble.com/posthog) on Dribbble... or just have a look around! diff --git a/contents/handbook/engineering/product-design.md b/contents/handbook/engineering/product-design.md index c7f8eff510df..0d3c6ade54d8 100644 --- a/contents/handbook/engineering/product-design.md +++ b/contents/handbook/engineering/product-design.md @@ -66,4 +66,4 @@ Usually during quick syncs like this, it's enough to help an engineer work throu Sometimes product design may push back if they simply don't have capacity. It's subjective when this may happen, and it'll usually be in cases where they feel they won't be as helpful based on the above. -[Read more about how product design works at PostHog](/handbook/brand/process) - _it's very unique!_ +[Read more about how product design works at PostHog](/handbook/engineering/product-design-process) - _it's very unique!_ diff --git a/contents/handbook/marketing/index.md b/contents/handbook/marketing/index.md index 18b198d4e534..205e5441590a 100644 --- a/contents/handbook/marketing/index.md +++ b/contents/handbook/marketing/index.md @@ -6,7 +6,16 @@ showTitle: true ## How marketing works -Marketing at PostHog is a collaborative effort across several teams. It is also specifically a multi-disciplinary creative team in it's own right. If that's confusing, you can check [Who can help me?](/handbook/marketing/ownership) for more on who to talk to. +Marketing at PostHog is a collaborative effort across several teams. There are six distinct teams that handle different aspects of marketing: + +- **Graphics** – Leads all art, design, illustration, and brand work for PostHog +- **Website** – Leads all matters related to posthog.com and handles some product design aspects +- **Marketing** – A multidisciplinary team that handles Product Marketing, Influencers & Partnerships, and other unowned marketing tasks +- **Editorial** – Leads content, newsletters, and social +- **YouTube** – Leads video +- **Docs & Wizard** – Leads on documentation and the wizard + +If you're not sure who to talk to, check [Who can help me?](/handbook/marketing/ownership). ## Marketing values diff --git a/contents/handbook/marketing/ownership.md b/contents/handbook/marketing/ownership.md index 18a21f040682..773be264bfc5 100644 --- a/contents/handbook/marketing/ownership.md +++ b/contents/handbook/marketing/ownership.md @@ -4,7 +4,7 @@ sidebar: Handbook showTitle: true --- -If you have a general marketing question, go to `#team-marketing` in Slack. +If you have a general marketing question, go to `#group-marketing-and-content` in Slack. If you need help with the website, go to `#posthogdotcom`. @@ -14,7 +14,7 @@ Here's a quick guide to who to ask if you want help with a specific marketing ac
I need a product marketer, but I don't know which -Product marketing is part of . You can see which PMM is focused on which team on the team page. If it's a team which doesn't currently have an assigned marketer, just ask in #team-marketing in Slack and tag the team lead. +Product marketing is part of . You can see which PMM is focused on which team on the team page. If it's a team which doesn't currently have an assigned marketer, just ask in #group-marketing-and-content in Slack and tag the team lead.
diff --git a/contents/handbook/wide-company.md b/contents/handbook/wide-company.md index cea369f7e290..8601ffcba056 100644 --- a/contents/handbook/wide-company.md +++ b/contents/handbook/wide-company.md @@ -23,7 +23,7 @@ As with any startup, the principles that govern these small teams are: - Can decide what to build within their own products - Can ship without outside interference as far as possible - No product management by default - - [No product design by default](/handbook/brand/process) + - [No product design by default](/handbook/engineering/product-design-process) - Should work directly with its own users (until it has hit product-market fit within PostHog's platform) - Should be small diff --git a/src/navs/index.js b/src/navs/index.js index b9b50b36c5f5..de86610149ff 100644 --- a/src/navs/index.js +++ b/src/navs/index.js @@ -517,44 +517,6 @@ export const handbookSidebar = [ }, ], }, - { - name: 'Brand & design', - url: '', - children: [ - { - name: 'Overview', - url: '/handbook/brand/overview', - }, - { - name: 'Brand strategy', - url: '/handbook/strategy/brand', - }, - { - name: 'Art requests', - url: '/handbook/brand/art-requests', - }, - { - name: 'Logos, brand, and hedgehogs', - url: '/handbook/company/brand-assets', - }, - { - name: 'Style guide', - url: '/handbook/brand/style-guide', - }, - { - name: 'Our design philosophy', - url: '/handbook/brand/philosophy', - }, - { - name: 'Product design for engineers', - url: '/handbook/engineering/product-design', - }, - { - name: 'Product design process', - url: '/handbook/brand/process', - }, - ], - }, { name: 'Content', url: '', @@ -962,6 +924,50 @@ export const handbookSidebar = [ name: 'Tech talks', url: '/handbook/engineering/tech-talks', }, + { + name: 'Product design', + url: '', + children: [ + { + name: 'Product design for engineers', + url: '/handbook/engineering/product-design', + }, + { + name: 'Product design process', + url: '/handbook/engineering/product-design-process', + }, + ], + }, + ], + }, + { + name: 'Graphics', + url: '', + children: [ + { + name: 'Overview', + url: '/handbook/brand/overview', + }, + { + name: 'Brand strategy', + url: '/handbook/strategy/brand', + }, + { + name: 'Art requests', + url: '/handbook/brand/art-requests', + }, + { + name: 'Logos, brand, and hedgehogs', + url: '/handbook/company/brand-assets', + }, + { + name: 'Style guide', + url: '/handbook/brand/style-guide', + }, + { + name: 'Our design philosophy', + url: '/handbook/brand/philosophy', + }, ], }, { @@ -1124,102 +1130,6 @@ export const handbookSidebar = [ }, ], }, - { - name: 'PostHog.com', - url: '', - children: [ - { - name: 'Overview', - url: '/handbook/engineering/posthog-com/overview', - }, - { - name: 'Developing the website', - url: '/handbook/engineering/posthog-com/developing-the-website', - }, - { - name: 'How PostHog.com works', - url: '/handbook/engineering/posthog-com/how-posthog-website-works', - }, - { - name: 'Designing PostHog.com', - url: '/handbook/brand/designing-posthog-website', - }, - { - name: 'Technical architecture', - url: '/handbook/engineering/posthog-com/technical-architecture', - }, - { - name: 'MDX setup', - url: '/handbook/engineering/posthog-com/mdx-setup', - }, - { - name: 'MDX components', - url: '/handbook/engineering/posthog-com/markdown', - }, - { - name: 'Uploading assets', - url: '/handbook/engineering/posthog-com/assets', - }, - { - name: 'Merch store', - url: '/handbook/engineering/posthog-com/merch-store', - }, - { - name: 'Posting a new job', - url: '/handbook/engineering/posthog-com/jobs', - }, - { - name: 'Managing cool tech jobs', - url: '/handbook/engineering/posthog-com/cool-tech-jobs', - }, - { - name: 'Managing small teams', - url: '/handbook/engineering/posthog-com/small-teams', - }, - { - name: 'Adding a team member', - url: '/handbook/engineering/posthog-com/add-team-member', - }, - { - name: 'Managing the company roadmap', - url: '/handbook/engineering/posthog-com/roadmap', - }, - { - name: 'Changelog entries', - url: '/handbook/engineering/posthog-com/changelog', - }, - { - name: 'Custom presentations', - url: '/handbook/engineering/posthog-com/presentations', - }, - { - name: 'Product & feature comparisons', - url: '/handbook/engineering/posthog-com/product-comparisons', - }, - { - name: 'Editing API docs', - url: '/handbook/engineering/posthog-com/api-docs', - }, - { - name: 'Community', - url: '', - children: [ - { - name: 'Overview', - url: '/handbook/community', - }, - { - name: 'Answering community questions', - url: '/handbook/community/questions', - }, - { - name: 'Profiles', - url: '/handbook/community/profiles', - }, - ], - }, - ], - }, { name: 'Product', url: '', @@ -1267,39 +1177,43 @@ export const handbookSidebar = [ ], }, { - name: 'Support', + name: 'RevOps', url: '', children: [ { name: 'Overview', - url: '/handbook/support/support-team', + url: '/handbook/growth/revops/overview', }, { - name: 'Customer support', - url: '/handbook/support/customer-support', + name: 'Revenue adjustments', + url: '/handbook/growth/revops/revenue-adjustments', }, { - name: 'Support team incident response', - url: '/handbook/support/support-incident-response', + name: 'Retention metrics', + url: '/handbook/growth/revops/retention-metrics', }, { - name: 'How we work', + name: 'Lifecycle analysis', + url: '/handbook/growth/revops/lifecycle-analysis', + }, + { + name: 'SalesOps', url: '', children: [ { - name: 'Technical support SMEs', - url: '/handbook/support/support-smes', + name: 'Refunds', + url: '/handbook/growth/sales/refunds', }, { - name: 'Support zero weeks', - url: '/handbook/support/support-zero', + name: 'Lead assignment during time off', + url: '/handbook/growth/revops/lead-assignment-ooo', + }, + { + name: 'Giving credits to customers', + url: '/handbook/growth/revops/credits', }, ], }, - { - name: 'Troubleshooting tips', - url: '/handbook/support/troubleshooting-tips', - }, ], }, { @@ -1670,40 +1584,132 @@ export const handbookSidebar = [ ], }, { - name: 'RevOps', + name: 'Support', url: '', children: [ { name: 'Overview', - url: '/handbook/growth/revops/overview', + url: '/handbook/support/support-team', }, { - name: 'Revenue adjustments', - url: '/handbook/growth/revops/revenue-adjustments', + name: 'Customer support', + url: '/handbook/support/customer-support', }, { - name: 'Retention metrics', - url: '/handbook/growth/revops/retention-metrics', + name: 'Support team incident response', + url: '/handbook/support/support-incident-response', }, { - name: 'Lifecycle analysis', - url: '/handbook/growth/revops/lifecycle-analysis', + name: 'How we work', + url: '', + children: [ + { + name: 'Technical support SMEs', + url: '/handbook/support/support-smes', + }, + { + name: 'Support zero weeks', + url: '/handbook/support/support-zero', + }, + ], }, { - name: 'SalesOps', + name: 'Troubleshooting tips', + url: '/handbook/support/troubleshooting-tips', + }, + ], + }, + { + name: 'Website', + url: '', + children: [ + { + name: 'Overview', + url: '/handbook/engineering/posthog-com/overview', + }, + { + name: 'Developing the website', + url: '/handbook/engineering/posthog-com/developing-the-website', + }, + { + name: 'How PostHog.com works', + url: '/handbook/engineering/posthog-com/how-posthog-website-works', + }, + { + name: 'Designing PostHog.com', + url: '/handbook/brand/designing-posthog-website', + }, + { + name: 'Technical architecture', + url: '/handbook/engineering/posthog-com/technical-architecture', + }, + { + name: 'MDX setup', + url: '/handbook/engineering/posthog-com/mdx-setup', + }, + { + name: 'MDX components', + url: '/handbook/engineering/posthog-com/markdown', + }, + { + name: 'Uploading assets', + url: '/handbook/engineering/posthog-com/assets', + }, + { + name: 'Merch store', + url: '/handbook/engineering/posthog-com/merch-store', + }, + { + name: 'Posting a new job', + url: '/handbook/engineering/posthog-com/jobs', + }, + { + name: 'Managing cool tech jobs', + url: '/handbook/engineering/posthog-com/cool-tech-jobs', + }, + { + name: 'Managing small teams', + url: '/handbook/engineering/posthog-com/small-teams', + }, + { + name: 'Adding a team member', + url: '/handbook/engineering/posthog-com/add-team-member', + }, + { + name: 'Managing the company roadmap', + url: '/handbook/engineering/posthog-com/roadmap', + }, + { + name: 'Changelog entries', + url: '/handbook/engineering/posthog-com/changelog', + }, + { + name: 'Custom presentations', + url: '/handbook/engineering/posthog-com/presentations', + }, + { + name: 'Product & feature comparisons', + url: '/handbook/engineering/posthog-com/product-comparisons', + }, + { + name: 'Editing API docs', + url: '/handbook/engineering/posthog-com/api-docs', + }, + { + name: 'Community', url: '', children: [ { - name: 'Refunds', - url: '/handbook/growth/sales/refunds', + name: 'Overview', + url: '/handbook/community', }, { - name: 'Lead assignment during time off', - url: '/handbook/growth/revops/lead-assignment-ooo', + name: 'Answering community questions', + url: '/handbook/community/questions', }, { - name: 'Giving credits to customers', - url: '/handbook/growth/revops/credits', + name: 'Profiles', + url: '/handbook/community/profiles', }, ], }, diff --git a/vercel.json b/vercel.json index 1c03288ca6b6..d98ce5cac828 100644 --- a/vercel.json +++ b/vercel.json @@ -1786,6 +1786,7 @@ { "source": "/eu", "destination": "/pricing" }, { "source": "/pricing/philosophy", "destination": "/pricing#philosophy" }, { "source": "/handbook/brand/brand-and-vibes", "destination": "/handbook/brand/overview" }, + { "source": "/handbook/brand/process", "destination": "/handbook/engineering/product-design-process" }, { "source": "/teams/max-ai", "destination": "/teams/posthog-ai" }, { "source": "/teams/twig", "destination": "/teams/posthog-code" }, { "source": "/teams/twig/:path*", "destination": "/teams/posthog-code/:path*" }, From e5d3d5af0f8c12c554ac4b34846c6f7946b3d3f0 Mon Sep 17 00:00:00 2001 From: Charles Cook Date: Thu, 23 Apr 2026 12:27:36 +0100 Subject: [PATCH 2/3] Update contents/handbook/engineering/product-design-process.md Co-authored-by: Joe Martin <84011561+joethreepwood@users.noreply.github.com> --- contents/handbook/engineering/product-design-process.md | 1 - 1 file changed, 1 deletion(-) diff --git a/contents/handbook/engineering/product-design-process.md b/contents/handbook/engineering/product-design-process.md index c0da4d328683..93ac69a44cc7 100644 --- a/contents/handbook/engineering/product-design-process.md +++ b/contents/handbook/engineering/product-design-process.md @@ -22,4 +22,3 @@ Need some custom artwork? Read the [art and branding request guidelines](/handbo ## Portfolio -You can find [PostHog's design portfolio](https://dribbble.com/posthog) on Dribbble... or just have a look around! From 2bb54e54328e004fa28c598fc2ed70b3c6f5e023 Mon Sep 17 00:00:00 2001 From: Joe Martin <84011561+joethreepwood@users.noreply.github.com> Date: Thu, 23 Apr 2026 14:06:45 +0100 Subject: [PATCH 3/3] Delete process.md --- contents/handbook/brand/process.md | 25 ------------------------- 1 file changed, 25 deletions(-) delete mode 100644 contents/handbook/brand/process.md diff --git a/contents/handbook/brand/process.md b/contents/handbook/brand/process.md deleted file mode 100644 index c0da4d328683..000000000000 --- a/contents/handbook/brand/process.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: Product design process -sidebar: Handbook -showTitle: true -hideAnchor: false ---- - -## No product design within small teams - -We encourage engineers to act like feature owners, carrying a project from ideation to completion. We maintain a design system in [Storybook](https://storybook.dev.posthog.dev/), so engineers can build high-quality features independently, as much as possible. - -Because engineers choose their sprint tasks near the beginning of a sprint (and product doesn't plan tasks _for_ engineers in advance), our process doesn't allow for us to have a product manager and a designer to work closely together before a task gets selected by an engineer. - -In our process of short, 2-week sprints with no pre-planning, design would become a blocker to an engineer quickly iterating on a feature. Thus, engineers don't get support from product designers. Product designers should deliver high quality components. The product teams should have people in them that can ship good-enough quality interfaces using those components. If that's not true, we should hire or move people around. - -Learn more about how we decide this in our [guide to working with product designers, for engineers](/handbook/engineering/product-design). - - -## Requesting artwork and brand materials. - -Need some custom artwork? Read the [art and branding request guidelines](/handbook/brand/art-requests). - -## Portfolio - -You can find [PostHog's design portfolio](https://dribbble.com/posthog) on Dribbble... or just have a look around!