Handbook: edits to LinkedIn, content, brand & product announcements pages by ivanagas · Pull Request #18180 · PostHog/posthog.com

ivanagas · 2026-07-03T22:10:26Z

Changes

Consolidated base PR for edits to five handbook pages (previously split across #18144–#18148, now combined here to simplify review). Each seed change is a small, safe fix; further edits are being added directly in GitHub.

LinkedIn — typo fixes ("LinkedInposting" → "LinkedIn posting", "a long the way" → "along the way")
Product announcements — trailing whitespace trim
Content overview — trailing whitespace trim
Brand in practice — grammar fix ("reviewed by in" → "reviewed in")
Voice & tone — table row alignment

Checklist

I've read the docs and/or content style guides.
Words are spelled using American English
Use relative URLs for internal links
I've checked the pages added or changed in the Vercel preview build
If I moved a page, I added a redirect in vercel.json

Created with PostHog from a Slack thread

Fix "LinkedInposting" -> "LinkedIn posting" heading and "a long the way" -> "along the way". Generated-By: PostHog Code Task-Id: dbe59f44-5b60-4c51-9758-a57553ddcdf4

Bring the product announcements, content overview, brand in practice, and voice & tone handbook edits onto this branch so they can be reviewed and edited in a single PR. Generated-By: PostHog Code Task-Id: dbe59f44-5b60-4c51-9758-a57553ddcdf4

Updated tone to include a positive emoji response.

github-actions · 2026-07-03T22:10:55Z

Deploy preview

Status	Details	Updated (UTC)
🟢 Ready	View preview	Jul 04, 2026 03:40AM

github-actions · 2026-07-03T22:11:24Z

Vale prose linter → found 9 errors, 41 warnings, 2 suggestions in your markdown

Full report → Copy the linter results into an LLM to batch-fix issues.

Linter being weird? Update the rules!

contents/handbook/brand/in-practice.md — 0 errors, 10 warnings, 2 suggestions

Line	Severity	Message	Rule
9:4	warning	'Website (posthog.com)' heading should be in sentence case, and product names should be capitalized.	`PostHogBase.SentenceCase`
9:13	warning	Use 'PostHog' instead of 'posthog'.	`Vale.Terms`
33:20	warning	'Runde' is a possible misspelling.	`PostHogBase.Spelling`
44:16	warning	'dialogs' is a possible misspelling.	`PostHogBase.Spelling`
127:22	suggestion	Prefer 'proper nouns or their/theirs' over 'his'.	`PostHogBase.Inclusivity`
127:42	suggestion	Prefer 'proper nouns or they' over 'he'.	`PostHogBase.Inclusivity`
134:35	warning	'logomark' is a possible misspelling.	`PostHogBase.Spelling`
134:59	warning	'wordmark' is a possible misspelling.	`PostHogBase.Spelling`
134:98	warning	'logomark' is a possible misspelling.	`PostHogBase.Spelling`
134:131	warning	'wordmark' is a possible misspelling.	`PostHogBase.Spelling`
135:33	warning	'logomark' is a possible misspelling.	`PostHogBase.Spelling`
142:4	warning	'YouTube & video' heading should be in sentence case, and product names should be capitalized.	`PostHogBase.SentenceCase`

contents/handbook/brand/tone.md — 1 errors, 5 warnings, 0 suggestions

Line	Severity	Message	Rule
43:29	warning	'C'mon' is a possible misspelling.	`PostHogBase.Spelling`
64:12	warning	'don'ts' is a possible misspelling.	`PostHogBase.Spelling`
70:4	warning	Capitalize 'Feature Flags' for PostHog's product. Use 'Feature flags' for the general industry concept.	`PostHogBase.ProductNames`
76:105	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
118:132	warning	'Triages' is a possible misspelling.	`PostHogBase.Spelling`
119:105	warning	'triages' is a possible misspelling.	`PostHogBase.Spelling`

contents/handbook/content/index.md — 0 errors, 4 warnings, 0 suggestions

Line	Severity	Message	Rule
24:51	warning	'PDFs' is a possible misspelling.	`PostHogBase.Spelling`
52:285	warning	'snackable' is a possible misspelling.	`PostHogBase.Spelling`
65:77	warning	Use 'PostHog' instead of 'posthog'.	`Vale.Terms`
73:5	warning	'1. SEO' heading should be in sentence case, and product names should be capitalized.	`PostHogBase.SentenceCase`

contents/handbook/content/linkedin.md — 8 errors, 16 warnings, 0 suggestions

Line	Severity	Message	Rule
12:1	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
13:1	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
14:1	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
15:1	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
16:1	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
17:1	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
18:69	warning	'deepdive' is a possible misspelling.	`PostHogBase.Spelling`
19:1	error	Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash.	`PostHogBase.EnDash`
28:29	error	'either' is repeated!	`Vale.Repetition`
63:4	warning	'Gergely' is a possible misspelling.	`PostHogBase.Spelling`
63:12	warning	'Orosz' is a possible misspelling.	`PostHogBase.Spelling`
65:8	warning	'Orbach' is a possible misspelling.	`PostHogBase.Spelling`
67:10	warning	'Rachitsky' is a possible misspelling.	`PostHogBase.Spelling`
71:4	warning	'Aakash' is a possible misspelling.	`PostHogBase.Spelling`
75:10	warning	'Huryn' is a possible misspelling.	`PostHogBase.Spelling`
77:4	warning	'Luca' is a possible misspelling.	`PostHogBase.Spelling`
77:9	warning	'Rossi' is a possible misspelling.	`PostHogBase.Spelling`
81:4	warning	'Alexandre' is a possible misspelling.	`PostHogBase.Spelling`
81:14	warning	'Zajac' is a possible misspelling.	`PostHogBase.Spelling`
83:4	warning	'Gregor' is a possible misspelling.	`PostHogBase.Spelling`
83:11	warning	'Ojstersek' is a possible misspelling.	`PostHogBase.Spelling`
87:4	warning	'Ashish' is a possible misspelling.	`PostHogBase.Spelling`
87:11	warning	'Pratap' is a possible misspelling.	`PostHogBase.Spelling`
87:68	warning	'Algomaster' is a possible misspelling.	`PostHogBase.Spelling`

contents/handbook/marketing/product-announcements.md — 0 errors, 6 warnings, 0 suggestions

Line	Severity	Message	Rule
7:162	warning	Use 'PostHog' instead of 'posthog'.	`Vale.Terms`
41:46	warning	Capitalize 'Surveys' for PostHog's product. Use 'surveys' for the general industry concept.	`PostHogBase.ProductNames`
58:1	warning	'Comms' is a possible misspelling.	`PostHogBase.Spelling`
80:12	warning	Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept.	`PostHogBase.ProductNames`
80:30	warning	Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept.	`PostHogBase.ProductNames`
88:177	warning	'comms' is a possible misspelling.	`PostHogBase.Spelling`

github-actions · 2026-07-03T22:20:44Z

Bundle report

Total JS (gzip)

6.29 MiB (no change)

Eager graph (static-import closure per entrypoint)

Entrypoint	Eager size	Budget	Modules
✅ `app`	24.22 MiB (no change)	report-only	5516

Largest modules in the app closure

Module	Size
`css ./node_modules/.pnpm/css-loader@5.2.7_webpack@5.101.3/node_modules/css-loader/dist/cjs.js??ruleSet[1].rules[8].oneOf[1].use[1]!./node_modules/.pnpm/postcss-loader@4.3.0_postcss@8.5.6_webpack@5.101.3/node_modules/postcss-loader/dist/cjs.js??ruleSet[1].rules[8].oneOf[1].use[2]!./src/styles/global.css`	708.1 KiB
`./src/components/Stickers/Stickers.tsx`	696.4 KiB
`./.cache/caches/gatsby-plugin-mdx/mdx-scopes-dir/31a094f140f119e73085d847ae81b99b.js + 2 modules`	584.2 KiB
`./node_modules/.pnpm/@radix-ui+react-icons@1.3.2_react@18.3.1/node_modules/@radix-ui/react-icons/dist/react-icons.esm.js`	481.4 KiB
`./node_modules/.pnpm/@codemirror+view@6.38.2/node_modules/@codemirror/view/dist/index.js`	458.1 KiB
`./node_modules/.pnpm/rehype-raw@7.0.0/node_modules/rehype-raw/lib/index.js + 29 modules`	395.1 KiB
`./node_modules/.pnpm/@posthog+icons@0.36.6_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@posthog/icons/dist/posthog-icons.cjs.js`	364.8 KiB
`./node_modules/.pnpm/@posthog+icons@0.36.6_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@posthog/icons/dist/posthog-icons.es.js`	354.8 KiB
`./src/hooks/useCustomers.tsx + 54 modules`	353.9 KiB
`./node_modules/.pnpm/react-markdown@8.0.7_@types+react@16.14.66_react@18.3.1/node_modules/react-markdown/lib/react-markdown.js + 88 modules`	351.4 KiB
`./node_modules/.pnpm/cloudinary-core@2.14.0_lodash@4.17.21/node_modules/cloudinary-core/cloudinary-core.js`	281.9 KiB
`./src/components/ProductComparisonTable/index.tsx + 116 modules`	267.6 KiB
`./node_modules/.pnpm/@codesandbox+sandpack-react@2.20.0_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@codesandbox/sandpack-react/dist/index.mjs`	266.6 KiB
`./node_modules/.pnpm/d3@7.9.0/node_modules/d3/src/index.js + 208 modules`	247.4 KiB
`./src/components/Pricing/PricingSlider/Slider.tsx + 87 modules`	239.9 KiB

Eager-graph budgets are report-only until a baseline is established. Sizes are gzip of public/**/*.js; eager size is webpack module source bytes.

…ok-linkedin-edits

…op, commit this change to `tone.md` (message like "Force equal-width columns in Social Media table"). 2. Push it up to your PR ([#18180](#18180)). You can leave the Terminal/dev server running or close it — either is fine, it won't affect the PR. Let me know if you want a hand with the commit/push step too. Was weirdly-sized, now equal

Rephrase the guideline on emojis to emphasize plain English.

Clarified the instruction regarding posting from the company account.

liamg-posthog added 6 commits July 2, 2026 14:59

Fix typos on LinkedIn handbook page

c526cf5

Fix "LinkedInposting" -> "LinkedIn posting" heading and "a long the way" -> "along the way". Generated-By: PostHog Code Task-Id: dbe59f44-5b60-4c51-9758-a57553ddcdf4

Edits to existing pages referencing social media

c10d859

Add emoji to positive feedback response

39759c3

Updated tone to include a positive emoji response.

Merge branch 'master' into posthog-code/handbook-linkedin-edits

efc3d45

Fix unclosed <br> tags breaking MDX build

63bc2d8

ivanagas assigned liamg-posthog Jul 3, 2026

liamg-posthog added 4 commits July 3, 2026 15:33

Merge remote-tracking branch 'origin/master' into posthog-code/handbo…

6fb4785

…ok-linkedin-edits

Update emoji guideline for brand tone

4ef27f1

Rephrase the guideline on emojis to emphasize plain English.

Update LinkedIn posting instructions for clarity

7413f69

Clarified the instruction regarding posting from the company account.

liamg-posthog approved these changes Jul 4, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Handbook: edits to LinkedIn, content, brand & product announcements pages#18180

Handbook: edits to LinkedIn, content, brand & product announcements pages#18180
ivanagas wants to merge 10 commits into
masterfrom
posthog-code/handbook-linkedin-edits

ivanagas commented Jul 3, 2026

Uh oh!

github-actions Bot commented Jul 3, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Jul 3, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Jul 3, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

ivanagas commented Jul 3, 2026

Changes

Checklist

Uh oh!

github-actions Bot commented Jul 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Deploy preview

Uh oh!

github-actions Bot commented Jul 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Jul 3, 2026

Bundle report

Total JS (gzip)

Eager graph (static-import closure per entrypoint)

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

github-actions Bot commented Jul 3, 2026 •

edited

Loading

github-actions Bot commented Jul 3, 2026 •

edited

Loading