The Community Advocates Program has been dissolved. Thank you for your patience while we work to deprecate these handbook pages. Please reach out to @community-team on slack if you need the Community Team's assistance. Also check out the Community Operations handbook page.
#community-advocateschat channel for questions that don't seem appropriate to use the issue tracker for.
@community-advocateshandle in GitLab.com to mention the team for comments in issues or MRs that require their attention.
The goal of community advocacy is to respond to all of the GitLab mentions and questions asked online in a timely manner.
#swagSlack channels and making sure that they are heard, and that we help them with our input and assistance.
As Community Advocates, we will often want to involve experts in a topic being discussed online. The Involving experts workflow section describes how we do it.
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.
If you or your team is unsure how to best collaborate on a community response, consider using one of these strategies:
The Community Advocates actively monitor and respond to the following set of channels.
In this overview:
|Facebook page messages||Zapier||Zendesk||✓|
|Hacker News||Hacker News mentions||Zapier||Zendesk and Slack: #hn-mentions||✓|
|Hacker News front page stories||Hacker News front page mentions||Zapier||Slack: #community-advocates||✓|
|Education Program||Education application form||Marketo||Salesforce and Zendesk||✓|
|Open Source Program||Open Source application form||Marketo||Salesforce and Zendesk||✓|
|Startups Program||Startup application form||Marketo||Salesforce and Zendesk||✓|
|E-mail (email@example.com)||Shop contact||E-mail alias||Zendesk||✓|
|E-mail (firstname.lastname@example.org)||Handbook||E-mail alias||Zendesk||✓|
|E-mail (email@example.com)||#movingtogitlab campaign (deprecated)||E-mail alias||Zendesk||✓|
|E-mail (firstname.lastname@example.org)||Support contact||E-mail alias||Zendesk||✓|
|E-mail (email@example.com)||Support contact||E-mail alias||Zendesk||✓|
|E-mail (firstname.lastname@example.org)||Support contact||E-mail alias||Zendesk||✓|
|E-mail (personal inbox)||E-mails to track as tickets||E-mail alias||Zendesk||✓|
|Website: blog||Disqus comments||Zapier||Zendesk, #mentions-of-gitlab||✓|
|Website: DevOps Tools||Disqus comments||Zapier||Zendesk and Slack: #devops-tools-comments||✓|
|Documentation||Disqus comments||Zapier||Slack: #docs-comments||✓ (Docs Team)|
|Stack Overflow||Stack Exchange mentions||Zapier||Zendesk||✓|
|GitLab forum||forum.gitlab.com||Zapier||Zendesk and Slack: #gitlab-forum||✓|
|Lobste.rs||lobste.rs mentions||Zapier||Slack: #mentions-of-gitlab||✖|
|Mailing list||GitLabHq Google Group (deprecated)||N/A||N/A||✖|
|Quora||GitLab Quora topic||N/A||N/A||✖|
|Wider community content||Blog post comments||N/A||N/A||✖|
At this time, the Community Advocates team spans across three main timezones: CST (Chinese Standard Time, UTC +8), CET (Central European Time, UTC +1) and CDT (Central Daylight Time, UTC -5). Our typical coverage based on these time zones is Monday - Friday from 8:00UTC to 22:00UTC, plus occasional weekend coverage for release days.
While this gives us the capacity to address most mentions during the working day, often important and/or urgent mentions happen outside our current coverage times.
This is the ideal case where there is coverage from the full team and we follow the regular workflows for each one of our monitored channels.
Community Advocates Coverage Handoff: Before ending your day, please review ongoing conversations and mentions in our channels (especially #advocates-fyi in Slack) to assess whether anything could potentially become important and/or urgent. If that is the case:
advocates-fyiSlack group for any urgent updates, announcements, or links to tickets. After you've reviewed and taken necessary action on these tickets, start your regular processing workflow.
Community Advocates: If a member of the Community Advocates team is offline during their regular working hours (e.g. due to Paid Time Off, illness or unforeseen events) for a day or more, and that leaves their timezone uncovered, please activate the Advocate for a day process with at least two additional advocates.
If the time offline extends more than a few days, it is advisable to find additional advocates and rotate their roles.
In general, if you notice an online mention that needs to be addressed, please ping
@advocates on the #community-advocates Slack channel. All Community Advocates have notifications enabled for this group handle and this channel –notifications are also sent if the handle is mentioned on any GitLab Slack channel.
You can also contact any of the Community Advocates directly via Slack or text message.
If required, please consider using the Marketing Rapid Response Process as well.
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.
Every month a different advocate has release advocate duty. It rotates on a monthly basis. If the release day takes place on a weekend, one of the advocates is assigned to monitor the traffic and to process mentions. We keep track of the assignments on the
Community Advocates GitLab team calendar. You can view our workflow page to see the advocates release day tasks.
Their role is to process and manage program applications as per the application management workflow.
GitLab uses Crowdin as a localization management platform to empower our wider community to help with translations of our software. Every time an issue is opened in the Crowdin platform, we get a new ticket in the Community Advocacy instance of Zendesk. These issues can be:
We don't have to do anything with tickets from the first 4 categories, so we have Zendesk triggers in place. They just automatically close these tickets as they come in.
Tickets from the fifth category are typically from community members that are reaching out because they want to translate to a language that isn't currently enabled in Crowdin. To add a new target language, navigate to settings in GitLab Crowdin project, click on
Languages, select the language that you want to add and click
Update. The new target language should be set.
Please direct all questions related to Crowdin tickets to the i18n Slack channel.
Community Advocates manage merchandise requests, inventory, and the merchandise tech stack.
During news cycles such as the Microsoft acquisition of GitHub, there may be an increase in new GitLab users. The movingtogitlab specific Twitter account highlights all the users who tweeted about switching to GitLab.
Advocates should always look for new users moving to GitLab and make sure to thank them and ask what the benefits of using our products are. When doing so, please follow the #movingtogitlab workflow.
When community advocates aren't available, or we expect high traffic on social media (because of some major outage, or some significant announcement), we should try to recruit more GitLab team members who would help us cover our social networks. Our Advocate for a Day page is meant to help assist anyone who has been asked to perform this duty.
Every Community Advocate owns one or more of the team's processes. These are called expertises.
From time to time we run expertise rotation rounds to ensure all Advocates are trained in all expertises.
The CustomersDot is the in-house platform to manage customer subscriptions. We use it mostly in the context of the Education, OSS and startup programs for:
Printfection is the swag management platform. Community Advocates use it to manage the inventory and orders for most swag items.
Salesforce is the CRM platform we use to support the Education, Open Source and Startup Programs.
Stickermule is the swag platform used to print and order custom stickers.
TanukiDesk is an in-house open source project. Its goal is to provide bidirectional communication between Zendesk and Disqus/HackerNews.
We're currently utilizing this app to work on Disqus mentions via TanukiDesk Disqus Channel app.
Purpose: The purpose of this shadow program is to build effective collaboration and community building strategies between the Community Advocates and the Social Media team.
The planning of this process can be followed on this GitLab issue.
Each month the marketing team hosts a Key Monthly Marketing Metics meeting. The advocates team is responsible for updating relevant data in the presentation slides.
Each quarter we define and have the opportunity to share our OKRs publicly. An advocate is responsible for creating an epic from the content in the quarter's OKR page by following the steps listed below.
Translating our OKRs into an epic each quarter is in line with our transparency value, and it helps us collaborate better as a team when it comes to our objectives and key results.
New Epicbutton in the upper right corner and follow the title naming convention "FY2X-QX OKR: enter name of OKR " (ex. FY21-Q1 OKR: Scale Community Advocates team)