Community Advocacy

Finding the Community Advocates

On this page


Community Advocate Resources


Role of Community Advocacy

Goal

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.

Plan

  1. Have discount codes that are easily distributed by team members
  2. Send every major contributor a personalized gift
  3. Host online sessions for content contributors
  4. Start keeping track of our core contributors
  5. Do the rest of the contributor journey

Vision

  1. GitLab has 1000's of active content contributors (e.g. for blogs, meetups, presentations, etc.)
  2. Being a core contributor is a very rewarding experience
  3. There are 10's of active GitLab/ConvDev meet-ups
  4. 100's of talks per year given at conferences and meetups
  5. Our most active content contributors come to our summits
  6. 100's of people contribute content about GitLab every month
  7. We use software that helps us to keep track of core contributors (can be forum, Highrise, software made for advocacy, or a custom Rails app)
  8. There is a core contributors page organized per region with the same information as the team page and what they contributed, where they work (if they have a linkedin profile), and a button to sent them an email via a form.
  9. We measure and optimize every step of the contributor journey

Respond to Every Community Question About GitLab Asked Online

Deliverable Scheduling

Release Advocate Duties

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:

HackerNews

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.

Handling mentions

Urgent and important mentions

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.

Examples

Mention Important Urgent Explanation
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.

Zendesk

Disqus

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 #docs-comments and #mentions-of-gitlab channels and mark every post with a :white_check_mark: to show it's been reviewed and handled.

Twitter

Tweets that mention @GitLab, or @GitLabStatus will create a ticket in Zendesk, and show up in the "Twitter" view. All responses should be sent from Zendesk.

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.

General

When resolving Twitter tickets you should:

  1. Use Play mode in the Twitter view. The default Twitter view will sort tickets by created date (ascending).
  2. Not skip any tickets
  3. Assign the ticket to yourself or ask in the appropriate chat channel if you don't know how to answer it
  4. Not cross assign tickets
Handles
Usage of Likes

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.

Direct Messages

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).

community@ email

Respond to an email sent to our community@ address.

Facebook

Messages sent to our Facebook page also feed into ZenDesk.

hn-mentions Slack channel

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:

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.

mentions-of-gitlab Slack channel

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:

  1. Product Hunt
  2. Hacker News
  3. Reddit
  4. YouTube
  5. Quora

These mentions are also piped by notify.ly.

All comments on our blog posts and any mention of GitLab on Lobsters also gets funneled to this channel using zapier.

Hacker News

Besides #hn-mentions channel, mentions of GitLab on HackerNews are also piped into the #mentions-of-gitlab Slack channel.

Reddit

Respond to mentions of GitLab on Reddit, especially ones in the GitLab Subreddit.

YouTube

Repond to comments made on the GitLab Youtube Channel.

Quora

Respond to questions about GitLab on Quora, especially the ones that appear in the GitLab Topic channel.

#movingtogitlab initiative

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.

Docs comments

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:

  1. Respond to the user (he gets an email with your response):
    • Sample response
  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!
  1. Make sure the response contains a link to our documentation process
  2. Delete the comment

Mailing List

Respond to questions on the GitLab Mailing List.

GitLab Forum

Questions from the GitLab Forum flow into ZenDesk, but can only be responded to from within the Forum environment.

Stack Overflow

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).

Community Interaction Archetypes

Stability Complaints

Feature Requests

General Questions / Issues with .com

Bug Reports

General Positivity

Tweets expressing positivity about GitLab.

Sample responses:

Others

Special Types

Notes / Remarks

External resources

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:

Involving Experts

When responding to community messages, you should always strive to involve a resident GitLab expert on the subject if possible.

This gives:

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 #devrel channel.

When trying to figure out who has expertise on what segment of the product, the handbook Product page has a section called "Who to talk to for what". The team page can also be useful.

Can You Please Respond to This?

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.

Handling swag

Internal GitLab Swag Ordering:

MVP Appreciation Gifts

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.

  1. Determine MVP after merge window closes, see #release-mvp channel
  2. Find MVP's contact information
    • An email address is usually stored in git commit data
    • A user might have email or twitter info on their profile
  3. Congratulate the MVP via email, ask for their shipping address, as well as any other relevant information (e.g. shirt size)
  4. Investigate the MVP's interests
    • If the MVP doesn't have a notable presence on social media, you may choose to ask them directly or send GitLab swag instead
  5. Choose a suitable gift (up to 200$ USD)
  6. Write a kind thank you message
  7. Send the gift
    • The MVP should ideally have the gift 48h before the post goes live, though shipping to people outside the United States can take longer and usually won't make it in time
  8. Verify shipment status
    • Make sure that it was sent
    • Make sure that it arrived
  9. Mention the MVP gift in the release post
    • Make sure there's a picture of the gift in the release post if it's available

Good Custom Swag Providers

Provider Website URL Example Pricing Note
CustomInk CustomInk T-Shirt Pricing  
RageOn RageOn Product Pricing  

Handling #swag channel requests

Handle swag requests made in the #swag channel.

Community swag requests:

Email your request to sponsorships@gitlab.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.

Requester

Here's the process for requesting a swag gift for a contributor/user/customer:

Request templates:

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

Community Advocates

NOTE: Please keep in mind the list of countries we do not do business in.

Thank you swag

Always take care of GitLab contributors.

Users speaking about GitLab

Users who tweet about their upcoming/previous talk about GitLab.

NOTE: Collect user information privately - via email.

GitLab Swag Shop

Adding items to the store

NOTE: For more information, see this official guide

Removing items from the store

Sending swag

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.

Initiatives

Diversity

NOTE: Please keep in mind the list of countries we do not do business in.

Email Templates

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 (ap@gitlab.com) 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

Education / OSS

Rejecting Applications

Response Templates

Namespace Verification Template
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
Sertifi eSign Email Template
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
Appliction Rejection
Education
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
OSS
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
Application Acceptance
Education
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
Gold
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

Troubleshooting

#movingtogitlab

Applications in Zendesk https://gitlab-community.zendesk.com/agent//

Supporting Community initiatives

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.

Outreach email template

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

Expertises

Every Community Advocate owns one or more of the processes that the CA team uses. These are called expertises.

Meet-ups