#devrelchat channel for questions that don't seem appropriate to use the issue tracker for.
The goal of community advocacy is to grow the number of active GitLab content contributors. We do this by increasing conversion in the contributor journey.
Every 22nd of the month we release a new version of GitLab. More often than not we get a spike in community mentions. To help deal with this we have dedicated release advocates that "own" the effort of responding to community mentions on/after a release.
The two channels that we see the biggest increases in are:
Most of our releases end up on HackerNews. Some of them hit the first page. These HackerNews posts are top priority for us to answer to. They're both important and urgent.
Every comment should get a response from someone from the company. Feel free to use this template. If you or the expert don't know the answer to a comment / remark please share your thoughts because every remark should have at least one response.
It's important to be able to recognize events that are both important and urgent. Some might be important but not urgent, others urgent but not important while some are neither important nor urgent. However, mentions that are both urgent and important should be handled as top priority. HackerNews is a channel that commonly sees this type of mentions.
These mentions might be intimidating and/or hard to answer by yourself. Please involve several topic experts to respond instead.
When this type of mention comes up during a weekend, please ping more people than usually. It's not considered rude (anyone and everyone can always snooze Slack notifications during weekends), you're just increasing the chance someone sees it in time.
|https://news.ycombinator.com/item?id=17032274||✖||✖||The OP mentions GitLab out of context.|
|https://news.ycombinator.com/item?id=17101902||✖||✓||This required an urgent response because the thread momentum was very perishable.|
|https://news.ycombinator.com/item?id=16914775||✓||✖||The OP expressed dissapointment with his support experience - This is important to address, but not time sensitive (a one or two hour response time woudln't have any difference in impact compared to a 6h response time).|
|https://news.ycombinator.com/item?id=13537052||✓||✓||Content is volatile and affects a lot of users and the company image. This needed to be addressed as soon as possible and with care.|
All the comments from our blog are handled by Disqus. There's an integration with ZenDesk in place which pipes posts to ZenDesk as tickets.
Go through the tickets per-post, see if all comments have received responses, respond if any need responses, then mark all the relevant tickets as Solved.
You should also monitor the
#mentions-of-gitlab channels and mark every post with a
:white_check_mark: to show it's been reviewed and handled.
If a tweet is responded to from TweetDeck, this risks duplicate responses. Responding from Zendesk also enables us to track our response times vs. our internal SLA.
Reply to almost all tweets, following the social media guidelines, and the guidelines on representing GitLab on Twitter regardless of whether the tweet is of a technical nature or not. Follow up with the support team if the issue is too complex to handle.
When resolving Twitter tickets you should:
Use "Likes" on Twitter for promoting positive feedback about our product since we direct users there when we want to show that people really love the product. Avoid using it for anything else.
We have DMs disabled, but they can be used if we DM a user first. This should only be used when the user needs to communicate with us privately (e.g. to give a mailing address).
Respond to an email sent to our
Messages sent to our Facebook page also feed into ZenDesk.
The #hn-mentions channel tracks mentions of GitLab on HackerNews. It is focused only on HN, so Community Advocates can enable notifications in this channel and respond as soon as possible. Every message should have a checkmark. This means that someone answered to the mention or decided it doesn't need a response.
When responding to a post about GitLab on HackerNews:
#devreland ping other
When someone leaves a link to the thread about GitLab on HackerNews, monitor that thread manually. Don't wait for the notifications in the #hn-mentions channel, because sometimes they're delayed by a few hours.
These mentions get piped to the Slack channel by notify.ly.
The #mentions-of-gitlab chat channel tracks mentions of GitLab across multiple sources. This allows us to respond to user requests across various platforms.
We currently track the following sources for GitLab mentions:
These mentions are also piped by notify.ly.
Respond to mentions of GitLab on Reddit, especially ones in the GitLab Subreddit.
Repond to comments made on the GitLab Youtube Channel.
Respond to questions about GitLab on Quora, especially the ones that appear in the GitLab Topic channel.
We have a daily reminder in the #devrel Slack channel to check for new
#movingtogitlab tweets. This is done through TweetDeck, and the goal is to keep the
#movingtogitlab trend and hashtag alive by retweeting appropriate tweets from our movingtogitlab Twitter account.
When you retweet every relevant post, leave a checkmark on the reminder, so the rest of the team knows that it's done.
These questions tend to be the most technical ones; consider involving experts when responding to them. Every comment should be answered.
Consider deleting the ones that aren't related to the documentation feedback. This kind of comments are distracting and aren't helpful to other users.
Types of comments that should be deleted:
Warning: If done poorly, it can cause more damage than good. Please consider these steps:
It looks like this issue is beyond the scope of the documentation comments. Please consider using <a href="https://forum.gitlab.com">our community forum</a>, or see <a href="https://about.gitlab.com/getting-help">other ways to get help</a>. Read more on how we handle documentation comments <a href="https://about.gitlab.com/handbook/marketing/community-marketing/community-advocacy/#docs-comments">in our handbook</a>. Thanks for using GitLab!
Respond to questions on the GitLab Mailing List.
Questions from the GitLab Forum flow into ZenDesk, but can only be responded to from within the Forum environment.
The Stack Overflow tagged questions that relate to GitLab flow into Zendesk, but can only be responded to from within Stack Overflow.
After you create an account on Stack Overflow (if you don't already have one), you should start by answering a few simple questions in an area you're familiar with (a language, web framework, development platform, API, etc.) or in the GitLab tag(s) if you feel comfortable. The goal is to get enough "Reputation" and have access to a few more features.
Consider offering some of your Reputation using bounties if a question is particularly advanced and you don't believe you can answer yourself, and the question seems deserving of an answer (e.g. if it has lots of upvotes).
Tweets expressing positivity about GitLab.
For posts about remote jobs and other kind of announcements that aren't strictly related to GitLab -> Use the
Mention ZenDesk macro
For issues related to self-managed instances -> Forward to Community Forum
When responding to community messages, you may face a situation where our documentation doesn't have an official solution. In these circumstances, you can consider replying with a link to an external resource.
Before that, consider documenting the missing piece. It is time-consuming, but it saves time for both you and your colleagues when this comes up again. Respond after updating the documentation. This approach encourages immediate documentation improvements/edits, and it allows avoiding all external resources. If you have any questions about writing the documentation, ask the relevant Technical Writer or Product Manager. When your content is ready, assign it to one of them for review.
If you determine that this question is too specific for our documentation and decide to use an external resource, please make sure that:
When responding to community messages, you should always strive to involve a resident GitLab expert on the subject if possible.
Please ping the expert in the relevant channel (e.g. in
#frontend if it's a frontend question) with:
@expert_username [LINK TO COMMUNITY COMMENT] https://about.gitlab.com/handbook/marketing/developer-relations/community-advocacy/#can-you-please-respond-to-this Can you please respond to this? Please answer in the social channel that the comment was originally posted in. If you don't know the answer, please share your thoughts because every remark should get a reponse.
And add an internal note with the link of the Slack message to the associated Zendesk ticket. If there is no Zendesk ticket related to the mention (e.g.a HackerNews mention) track it in the
You got a link to this because we'd like you to respond to the mentioned community comment. We want to make sure we give the best answer possible by connecting the wider community with our experts and expose you to more community feedback.
When responding to community mentions, you should check out the social media guidelines. Please answer in the social channel that the comment was originally posted in - discussing it internally via Slack makes it impossible for the community member to interact.
If you can't respond to the linked comment, that's OK, but please quickly let the person who pinged you know so they can ping someone else.
Each 22nd of the month is a release day - every release we pick a Most Valuable Person and thank them for their contributions. We send them some GitLab swag as a thank you (e.g. a hoodie, socks, and a handmade tanuki). There's also the option of sending personalized swag - see custom swag providers.
|Provider||Website URL||Example Pricing||Note|
Handle swag requests made in the #swag channel.
Email your request to email@example.com. In your request please include the expected number of guests, the best shipping address, and phone number along with what kind of swag you are hoping for. The swag we have available can be found on our online store. Note: We recommend you request swag at least 4 weeks out from the event date or we may not be able to accommodate your request.
Here's the process for requesting a swag gift for a contributor/user/customer:
https://twitter.com/gitlab/status/884983979992121344 - John Doe - firstname.lastname@example.org
https://twitter.com/gitlab/status/884983979992121344 - John Doe - email@example.com - 1233 Howard St 2F, CA, USA - 1 x L T-Shirt & 2 large stickers
NOTE: If you don't specify which swag to send, we'll send a standard package (T-Shirt + 2 stickers) NOTE: Please keep a single swag request confined to one message to avoid clutter
NOTE: Please keep in mind the list of countries we do not do business in.
Always take care of GitLab contributors.
Users who tweet about their upcoming/previous talk about GitLab.
NOTE: Collect user information privately - via email.
NOTE: For more information, see this official guide
NOTE: For more information, see this offical guide
Consider using https://www.stickermule.com for sending stickers since Printfection inventory is limited. If Stickermule doesn't work for you, then use Printfection instead.
NOTE: Always check Printfection inventory and item availability before sending.
NOTE: Please keep in mind the list of countries we do not do business in.
Hiya, Thank you so much for applying, considering GitLab as a sponsor and hosting such an awesome event! We'll gladly sponsor it! You should send an invoice to Accounts Payable (firstname.lastname@example.org) along with sending this MR link LINK in the body of the email for verification purposes. Regards, Your Name
Hi, Thank you so much for considering GitLab as a sponsor. Unfortunately we're able to extend the diversity sponsorship grant only to events whose primary focus is promoting diversity (inclusion of underrepresented groups) in tech. This says nothing bad about your event; it's awesome! We're just looking for a different profile of events to sponsor. Regards, Your Name
Information for GitLab.com Gold Upgrades: Groups must follow these instructions to authenticate. Your subscription has been uploaded and you may follow these instructions to authenticate your groups: 1. Please visit https://customers.gitlab.com/customers/password/new to reset your account password 2. After logging in, please access the "Subscriptions" menu 3. You'll be able to click on "Edit" over a subscription 4. You'll be redirected to GitLab.com for OAuth login 5. At this point, you need to make sure you're logging in using the account you want to license on GitLab.com 6. Please select the Group you want to license then click onto "Update" Please let me know if you have any questions, always happy to help. Regards, YOUR_NAME
Hello, We’re excited to tell you that your application for the GitLab (EDU or OSS) program has been approved and processed. We’re sending you a quote that you need to sign after which you’ll have to accept our EULA. Upon acceptance, you’ll get the license key delivered to you via mail. Regards, YOUR_NAME
Hi, Thanks for applying to GitLab’s EDU program. Unfortunately, we couldn’t accept your application. Please refer to the eligibility requirements listed at https://about.gitlab.com/education/. A common reason for rejection is students applying on behalf of their University. We’re only able to accept applications submitted by University staff, as part of the process is signing a legal document on behalf of the University. Another common reason is duplicate applications. We’re only able to accept one application per University. This isn’t to discriminate against smaller independent groups at universities, but rather to prevent the program from growing into unmaintainability. Regards, YOUR_NAME
Hi, Thanks for applying to GitLab’s OSS program. Unfortunately, we couldn’t accept your application. Please refer to the eligibility requirements listed at https://gitlab.com/gitlab-com/gitlab-oss/. A common reason for rejection is the project not being licensed under one of the OSI approved licenses (see https://opensource.org/licenses/alphabetical for a list). Regards, YOUR_NAME
Hello NAME, Thank you so much for applying for our GitLab Ultimate for Education program. We’re happy to inform you that your application is accepted! We’ll follow up shortly asking for additional information if required. Thanks for being a part of the GitLab community :) Regards, YOUR NAME
Hello NAME, Thank you so much for applying for our GitLab.com Gold for Education program. We’re happy to inform you that your application is accepted! We’ll follow up shortly asking for additional information if required. Thanks for being a part of the GitLab community :) Regards, YOUR NAME
Applications in Zendesk https://gitlab-community.zendesk.com/agent//
When we see outstanding articles about GitLab from our wider community, we should acknowledge the author.
Please create an issue (title: Supporting Community initiative - "NAME") for every such initiative to track our effort of supporting the community member in the Community Advocacy Issue Tracker.
This is an email template for outreach that should be used to contact those users, thank them for their contributions and offer further support.
Hello NAME, I'm reaching out to thank you for being such an incredible part of the GitLab community! Specifically, for taking the time to write about our product and help us grow our community. We appreciate everyone's effort to spread the word about GitLab, especially when it's an individual initiative. This is something that we really like because it is the ultimate sign that we're on the right path with our vision. We're so blessed to have such an awesome community, and we'd like to hear how can we thank you in the best possible way! Is there something we can do to support you better? There are several things that we can think of: 1. Let us know if you want $100 of free swag from https://shop.gitlab.com/ so that we can send you a coupon. 1. Would you like us to cross-post this on our blog? 1. Is there any technical support we could offer you as you're working with GitLab? 1. Would you like to be introduced to GitLab developers so that you can discuss more advanced topics? 1. Would you be interested in doing webinars or blog posts together with us? Finally, please consider adding yourself to the speaker's list if you're intersted in speaking about GitLab: https://about.gitlab.com/find-a-speaker. I'm looking forward to hearing back from you, NAME. Could you please continue the conversation in the following issue LINK. If you have any other questions, feel free to include them in your reply. Thanks for promoting GitLab. Take care and have a great day! Sincerely, YOUR_NAME
Every Community Advocate owns one or more of the processes that the CA team uses. These are called expertises.