Hacker News

1. You are here:
2. Handbook
3. Marketing
4. Community Relations
5. Developer Evangelism
6. Hacker News

Maintained by:

On this page

• Overview
• Workflow
• Best practices
• Social media guidelines
• Automation

Overview

Hacker News is an important social channel. Threads that mention GitLab's structure, values, product vision, or other sensitive blog posts, articles, etc. should be treated as important, while posts about GitLab that land on the front page of Hacker News should be treated as both important and urgent.

GitLab mentions on Hacker News are tracked on the #hn-mentions Slack channel. Posts about GitLab that land on the front page of Hacker News generate a notification that is shared in #community-relations.

Workflow

1. When alerted by the "Hacker News Front Page Bot" that an article referencing GitLab is on the Front Page of Hacker News, a Developer Evangelists should coordinate to ensure a DRI is assigned to the post to review, monitor the comments, and respond accordingly.
2. Developer Evangelists should also review the #hn-mentions Slack channel 1-2 times per day for mentions that require a response. If you are able to provide a quick response/resource, reply on news.ycombinator.com using your personal Hacker News account and indicate that you replied by leaving a :white_check_mark: on the Slack comment. Note that the window to edit a comment is 2 hours, afterwards you cannot edit or delete a Hacker News comment.
3. If necessary, you may also wish to share comments with relevant experts who may be able to provide more detailed or insightful comments. This can be done by sharing relevant posts or comments in an appropriate Slack channel if you judge additional input is required.

Best practices

When responding to a post about GitLab on Hacker News:

• Don't post answers that are almost the same, link to the original one instead.
• Address multi-faceted comments by breaking them down and using points, numbering and quoting.
• When someone posts a Hacker News thread link, monitor that thread manually. Don't wait for the notifications in the #hn-mentions channel, because sometimes they're delayed by a few hours.

Social media guidelines

• Never submit GitLab content to Hacker News. Submission gets more credibility if a non-GitLab Hacker News community member posts it, we should focus on making our posts interesting instead of on submitting it.
• Don't share links to Hacker News stories/comments on Slack or Twitter and ask others to upvote because it might set off the voting detector.
• Don't make the first comment on a Hacker post, allow people to leave comments and ask questions.
• Avoid using corporate jargon like 'PeopleOps'.
• Always address the Hacker News community as peers. Be sure to always be modest and grateful in responses.
• If you comment yourself make sure it is interesting and relevant.
• Make yourself familiar with A List of Hacker News's Undocumented Features and Behaviors to understand Hacker News behaviour and moderation rules.
• Check the tone of your response: Don’t be defensive, but instead share your point of view.
• Try to teach people something interesting they didn’t know already.
• Add value to your post with data points or direct links.

Note: You can find the full list of social media guidelines here

Automation

Hacker News mentions are piped to Community Zendesk and the #hn-mentions Slack channel by Zapier.