Hacker News new | past | comments | ask | show | jobs | submit login
Show HN: Q&A.js – add threaded discussions to any page of your docs or website (posthog.com)
9 points by james_impliu on April 28, 2022 | hide | past | favorite | 5 comments



Hi HN,

Thanks HN: I'm James - I'm a cofounder of PostHog (popular open source project), which was born on HackerNews in 2020

Along the way, we created a Slack group that quickly grew to a couple of thousand users - mostly needing support with the product. At the same time, we saw signs that docs are critical. For example, people who searched our docs are 8x as likely to succeed with our product.

Then we asked ourselves - why not make it possible to ask questions, right in our docs?

Out of 100s of thousands of visitors, only a small percentage make it into Slack (and it'd be the same if we used Discord), so can we serve questions and answers in the context of what they're trying to do. As a bonus, this would also make everything searchable.

Then we asked ourselves - why not also make this open source for anyone to use?

This means that far more people can benefit, and it'll generate word of mouth growth about who we are - hopefully bringing some extra customers in the long run. Simple as that. We may charge if we get lots of usage and once the product is more mature for the cloud version. If it's not popular, we're going to be using and extending it ourselves anyway :)


How does question / answer persistence happen? Is this intended to be sync or async?


Questions and replies are saved in a database. When a question is asked, you can reply directly on the page it was asked on or (if you are an organization admin) in the Squeak! dashboard. All replies will appear in the original thread and the OP/others can ask follow up questions.


Is there an ability to approve questions before they are displayed?

Wondering about the spam that we see on other comment plugins


Yes, there is. You can approve both questions and responses fro this exact reason




Consider applying for YC's Fall 2025 batch! Applications are open till Aug 4

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: