Commit ddcb1364 authored by Michael Friedrich's avatar Michael Friedrich 🌱
Browse files

Dev Advocacy handbook cleanup and updates, 2026-06

parent 21be3d61
Loading
Loading
Loading
Loading
+2 −2
Original line number Diff line number Diff line
@@ -96,8 +96,8 @@ We are members of the [Developer Relations team](/handbook/marketing/developer-r
| [Fatima Sarah Khalid](https://gitlab.com/sugaroverflow) <br/> Senior Developer Advocate | Community Engagement, DevSecOps | English | [LinkedIn Live](/handbook/marketing/developer-relations/developer-advocacy/projects/#linkedin-lives-in-collaboration-with-the-social-team), [Community Engagement](/handbook/marketing/developer-relations/developer-advocacy/#community-engagement) | CI/CD, C++, PHP, JavaScript | |
| [Fernando Diaz](https://gitlab.com/fjdiaz) <br/> Staff Developer Advocate | DevSecOps with a focus on Security and Compliance | English, Spanish | [GitLab demos on YouTube](/handbook/marketing/developer-relations/developer-advocacy/content/#youtube-playlists), Analyst relations demos, [event support](/handbook/marketing/developer-relations/developer-advocacy/#corporate-event-support), [Security and Governance tutorials](https://gitlab.com/gitlab-da/tutorials/security-and-governance) | Security, Kubernetes, CI/CD, Python |  |
| [Itzik Gan-Baruch](https://gitlab.com/iganbaruch) <br/> Staff Developer Advocate | DevSecOps with a focus on CI/CD, CI/CD Catalog, Security | English, Hebrew | [Product tours](/handbook/marketing/developer-relations/developer-advocacy/content/#product-tours), [Click-through demos](/handbook/marketing/developer-relations/developer-advocacy/content/#click-through-demos), [CI/CD components](/handbook/marketing/developer-relations/developer-advocacy/projects/#cicd-components-catalog) |  Remote Development, CI/CD, Value Stream Management |  |
| [John Coghlan](https://gitlab.com/john-coghlan) <br/> Director, Developer Advocacy | Strategy and Planning in Developer Advocacy | English | | | [Website](https://coghlan.me/) |
| [Michael Friedrich](https://gitlab.com/dnsmichi) <br/> Principal Developer Advocate | DevSecOps with a focus on Agentic AI adoption, [Global AI SME](/handbook/solutions-architects/sa-practices/subject-matter-experts/sme-program/)  | English, German | [maintained talks](/handbook/marketing/developer-relations/developer-advocacy/content/#maintained-talks), [workshops](/handbook/marketing/developer-relations/developer-advocacy/content/#workshops), [event strategy](https://gitlab.com/groups/gitlab-com/marketing/developer-relations/-/epics?label_name%5B%5D=DevRel-Events), [competitive research](https://internal.gitlab.com/handbook/marketing/developer-relations/developer-advocacy/competitive-research/) | DevSecOps, AI, Embedded, Python, C/C++, Rust | [README](/handbook/marketing/readmes/michael-friedrich/), [Talks](https://dnsmichi.com/talks/), [Portfolio](https://dnsmichi.com/portfolio/) |
| [John Coghlan](https://gitlab.com/john-coghlan) <br/> Senior Director, Developer Advocacy | Strategy and Planning in Developer Advocacy | English | | | [Website](https://coghlan.me/) |
| [Michael Friedrich](https://gitlab.com/dnsmichi) <br/> Principal Developer Advocate | DevSecOps with a focus on Agentic AI modernization, [AI SME](/handbook/solutions-architects/sa-practices/subject-matter-experts/sme-program/) | English, German | [maintained talks](/handbook/marketing/developer-relations/developer-advocacy/content/#maintained-talks), [event strategy](https://gitlab.com/groups/gitlab-com/marketing/developer-relations/-/epics?label_name%5B%5D=DevRel-Events), [competitive research](https://internal.gitlab.com/handbook/marketing/developer-relations/developer-advocacy/competitive-research/) | DevSecOps, AI, Embedded, Python, C/C++, Rust | [README](/handbook/marketing/readmes/michael-friedrich/), [Talks](https://dnsmichi.com/talks/), [Portfolio](https://dnsmichi.com/portfolio/) |
| [William Arias](https://gitlab.com/waarias) <br/> Staff Developer Advocate | DevSecOps with a focus on AI/ML, Sec and Data | English, Spanish | Support Ticket Sentiment Analysis, Competitive Research, Analyst relations demos, [End-to-end DevSecOps Platform](/handbook/marketing/developer-relations/developer-advocacy/projects/#organisation-structure) | CI/CD, AI/ML, Kubernetes, Security, Python, C |  |

## <i class="fa fa-tasks" aria-hidden="true"></i> What we do
+1 −1
Original line number Diff line number Diff line
@@ -29,7 +29,7 @@ To request that a Developer Advocate submits a CFP to your event, please:

### CFP Management

For every CFP process we are participating in, a [CFP issue](https://gitlab.com/gitlab-com/marketing/developer-relations/developer-advocacy/developer-advocacy-meta/-/issues/new?issuable_template=cfp-meta) is created with details about the event, requirements for CFP submissions and any other relevant information that might be useful to potential speakers. The issue template contains guide on the necessary steps needed to ensure we keep track of all the submissions for each CFP.
For every CFP process we are participating in, a [CFP issue](https://gitlab.com/gitlab-com/marketing/developer-relations/developer-advocacy/developer-advocacy-meta/-/issues/new?issuable_template=cfp-meta) is created with details about the event, requirements for CFP submissions and any other relevant information that might be useful to potential speakers. The issue template contains a guide on the necessary steps needed to ensure we keep track of all the submissions for each CFP.

#### Issue Workflow

+13 −10
Original line number Diff line number Diff line
@@ -7,7 +7,7 @@ Teams and divisions can request consultancy in areas where [Developer Advocates

## Organization

Consultancy requests are labelled using the [`DA-Consulting::` scoped labels](/handbook/marketing/developer-relations/developer-advocacy/workflow/#consulting-labels), with the [`DA-Type::Consulting` label as pre-filtered list](https://gitlab.com/gitlab-com/marketing/developer-relations/developer-advocacy/developer-advocacy-meta/-/issues/?sort=updated_desc&state=opened&label_name%5B%5D=DA-Type%3A%3AConsulting&first_page_size=20).
Consultancy requests are labelled using the [`DA-Consulting::` scoped labels](/handbook/marketing/developer-relations/developer-advocacy/workflow/#consulting-labels), with the [`DA-Type::Consulting` label as pre-filtered list](https://gitlab.com/gitlab-com/marketing/developer-relations/developer-advocacy/developer-advocacy-meta/-/issues/?sort=updated_desc&state=opened&label_name%5B%5D=DA-Type%3A%3AConsulting&first_page_size=20). Issues are grouped in a [yearly consultancy epic](https://gitlab.com/groups/gitlab-com/marketing/developer-relations/-/work_items?sort=created_date&state=opened&label_name%5B%5D=DA-Type%3A%3AConsulting&type%5B%5D=8&first_page_size=20).

### Request developer advocate consultancy

@@ -27,28 +27,29 @@ There is a wide variety of areas and topics that can be requested. It is importa

Generally, all product areas, features and technology can be requested. The sections below document a few recent examples of requests and their results.

### GitLab Duo / AI Adoption
### GitLab Duo Agent Platform Adoption

Goal: Help customers adopt GitLab Duo and AI-powered DevSecOps workflows.
Goal: Help customers adopt GitLab Duo Agent Platform.

Developer Advocates are encouraged to help with

- (Live) programming workshops, when fluent and confident in the requested language together with GitLab Duo.
- Code challenges for customer engineering teams to test GitLab Duo.
- (Live) programming workshops, when fluent and confident in the requested language.
- GitLab UI and IDE setup and troubleshooting.
- Latest product updates and improvements.
- Best practice resources, demos, product tours, and use cases (see [content library](/handbook/marketing/developer-relations/developer-advocacy/content/#content-library))
- Support field teams in Slack ([#ai-field-strategy](https://gitlab.enterprise.slack.com/archives/C051SLP8WNB), [#ai-sme-request](https://gitlab.enterprise.slack.com/archives/C05CWJ93WM7), [#ai-field-technical](https://gitlab.enterprise.slack.com/archives/C053WFAK56U)).
- Support field teams in Slack, [#sme-ai](https://gitlab.enterprise.slack.com/archives/C05GK6M7FBQ)

Collaboration for customer workshops is important. [Solution Architects](/handbook/solutions-architects/) lead the [Proof of Value (PoV) workshops for GitLab Duo and AI](/handbook/solutions-architects/playbooks/pov/ai/). They get help building the workshop outline from the [SA Demo Architects](/handbook/solutions-architects/center-of-excellence/demo-architecture/) and [Customer Success Management team](/handbook/customer-success/). Developer Advocates are encouraged to help with programming workshops, IDE setup and troubleshooting, and generally sharing best practices as a developer with customer's (engineering) teams.
Cross-functional collaboration for customer workshops is required: [Solution Architects](/handbook/solutions-architects/) lead the [Proof of Value (PoV) workshops for GitLab Duo and AI](/handbook/solutions-architects/playbooks/pov/ai/). They get help building the workshop outline from the [SA Demo Architects](/handbook/solutions-architects/center-of-excellence/demo-architecture/) and [Customer Success Management team](/handbook/customer-success/). Developer Advocates are encouraged to help with programming workshops, IDE setup and troubleshooting, and generally sharing best practices as a developer with customer's (engineering) teams.

Customer feedback can inspire bug reports, feature proposals, documentation updates, blog tutorials, demo stories and much more. Make sure to always listen and take notes during customer engagements.

Customer adoption engagement examples are available in the [FY25Q2 OKR KR](https://gitlab.com/gitlab-com/gitlab-OKRs/-/work_items/8073), the [GitLab Duo (AI) Adoption FY25 (DevRel) epic](https://gitlab.com/groups/gitlab-com/marketing/developer-relations/-/epics/475) and [this pre-filtered issue list](https://gitlab.com/gitlab-com/marketing/developer-relations/developer-advocacy/developer-advocacy-meta/-/issues/?sort=updated_desc&state=all&label_name%5B%5D=DA-Type%3A%3AConsulting&search=duo&first_page_size=20).
Recent customer workshop examples are available in the [pre-filtered Duo Agent Platform consulting issues](https://gitlab.com/gitlab-com/marketing/developer-relations/developer-advocacy/developer-advocacy-meta/-/issues/?sort=updated_desc&state=all&label_name%5B%5D=DA-Type%3A%3AConsulting&search=dap&first_page_size=20) (internal).

{{% details summary="Archived results for Duo Enterprise" %}}

Results:
Customer adoption engagement examples are available in the [FY25Q2 OKR KR](https://gitlab.com/gitlab-com/gitlab-OKRs/-/work_items/8073), the [GitLab Duo (AI) Adoption FY25 (DevRel) epic](https://gitlab.com/groups/gitlab-com/marketing/developer-relations/-/epics/475) and [this pre-filtered issue list](https://gitlab.com/gitlab-com/marketing/developer-relations/developer-advocacy/developer-advocacy-meta/-/issues/?sort=updated_desc&state=all&label_name%5B%5D=DA-Type%3A%3AConsulting&search=duo&first_page_size=20).

- Customer workshops for GitLab Duo ([full maintained list in the content handbook](/handbook/marketing/developer-relations/developer-advocacy/content/#workshops))
- Customer workshops for GitLab Duo ([list in the content handbook](/handbook/marketing/developer-relations/developer-advocacy/content/#workshops))
  - [GitLab Duo Use Case - Python workshop 2024-07-10](https://gitlab.com/gitlab-da/use-cases/ai/ai-workshops/gitlab-duo-use-case-python-2024-07-10)
  - [Build your own adventure with GitLab Duo - C++ observability tool with embedded hardware sensors](https://gitlab.com/gitlab-da/use-cases/ai/ai-workshops/gitlab-duo-workshop-build-your-own-adventure-cpp-2024-12-05)
- Blog: Best practice tutorials for customers and field teams ([AI/ML blog category](https://about.gitlab.com/blog/categories/ai-ml/)/)
@@ -61,6 +62,8 @@ Results:
- Product/Engineering: Feature proposals and bug reports ([FY25 epic](https://gitlab.com/groups/gitlab-com/marketing/developer-relations/-/epics/475#feature-proposals) (internal)).
  - Add `/fix` slash command for Duo Chat ([issue](https://gitlab.com/gitlab-org/gitlab/-/issues/443366)).

{{% /details %}}

SME DRI: @dnsmichi

### MLOps Adoption
+12 −4
Original line number Diff line number Diff line
@@ -147,11 +147,13 @@ GitLab Unfiltered YouTube channel:
- [Dev Advocacy: GitLab Duo Agent Platform use cases](https://www.youtube.com/playlist?list=PL05JrBw4t0Ko7aR6sM8e4uXGYtjs4-NqK)
- [Contributor Success AI Catalog / Duo Agent Platform Demos](https://www.youtube.com/playlist?list=PL05JrBw4t0Kq5vFCEQLrowmwGGi5YmCJK), user stories demonstrating the power of the AI catalog and encouraging everyone to contribute

Archive:
{{% details summary="Archive" %}}

- [GitLab Duo Coffee Chat](/handbook/marketing/developer-relations/developer-advocacy/projects/#gitlab-duo-coffee-chat), learning sessions with GitLab Duo and AI. (status: inactive)
- [DevOps with GitLab Duo](https://www.youtube.com/playlist?list=PL05JrBw4t0Krzu4U6gO3tS738hlsQGFz5), learning sessions with GitLab Duo, DevOps and AI. (status: inactive)

{{% /details %}}

#### Upload Videos to GitLab Unfiltered channel

Starting from July 2025, team members are encouraged to upload videos to `GitLab Unfiltered` using [GitLab Vidoe Scanner](https://internal.gitlab.com/handbook/security/product_security/token-leaks/video_scanner/), which is an internal service to help team members mitigate token leak risks in videos published to the GitLab Unfiltered Channel.
@@ -170,7 +172,7 @@ These talks are maintained:
|-------|------|-------|-----------|---------|-----|
| Efficient DevSecOps workflows with a little help from My AI Agents | Agentic AI, GitLab Duo Agent Platform | Use cases and problem solving, live demos and AMA | GitLab DACH Roadshow 2025 [recording](https://www.youtube.com/watch?v=amJQkKhe5ys), slides: [public](https://dnsmichi.click/efficient-devsecops-ai-agents-gitlab-dach-roadshow-2025), [internal](https://docs.google.com/presentation/d/1YMOQf-5hNzCyfUS2w6yvvDlfu_FqmYebkyxmeFWTyOU/edit), Demo: [Tanuki IoT Platform](https://gitlab.com/gitlab-da/use-cases/ai/gitlab-duo-agent-platform/demo-environments/tanuki-iot-platform) | 2025-12-04 | @dnsmichi |

Archive:
{{% details summary="Archive" %}}

| Title | Area | Focus | Resources | Updated | DRI |
|-------|------|-------|-----------|---------|-----|
@@ -179,13 +181,15 @@ Archive:
| Learning AI 101: Practical Foundations for Developers | Agentic AI | Learning LLMs, RAG, Tools, Agents, MCP use cases and practical prompts, etc. | Open Source @ Siemens 2025 [recording](https://www.youtube.com/watch?v=6NxSJmpjxfo), slides: [public](https://dnsmichi.click/learning-ai-101-os-siemens-2025), [internal](https://docs.google.com/presentation/d/1PUCUrVzKnzc25md8gbh1jYznz-dUFfQcENvbR9xUJ7k/edit) | 2025-06-03 | @dnsmichi |
| Efficient DevSecOps workflows with a little help from AI | AI, GitLab Duo | Product use cases with Duo | DACH Roadshow 2024 slides: [public](https://go.gitlab.com/JRFMG4), [internal](https://docs.google.com/presentation/d/1Pm8yT46jpcc3kY0PLZqZlG2slIiFyZiQPKFEgyqqstw/edit)  | 2024-11-14 | @dnsmichi |

{{% /details %}}

### Workshops

The Developer Advocacy team maintains workshops in different product and focus areas. A workshop can be of different types: Hands-on with audience participating live in the exercises (training course), or showcase live demo/programming sessions where the audience engages with questions. Workshops should be created in collaboration with the [Solution Architect](/handbook/solutions-architects/) and  [Customer Success](/handbook/customer-success/) teams, and aligned with business goals.

> Note: Specific customer focussed workshops can be requested following the [customer consultancy handbook](/handbook/marketing/developer-relations/developer-advocacy/consultancy/).

Archive:
{{% details summary="Archive" %}}

| Title | Area | Type | Focus | DRI | Resources |
|-------|------|------|-------|-----|-----------|
@@ -193,6 +197,8 @@ Archive:
| GitLab Duo best practices - Build a Python shop app | GitLab Duo | Showcase, audience watching/engaging, Sales Proof-of-value workshops (60min + async content) | Python, shop app | @dnsmichi | [2024-05-07 livestream with Eddie Jaoude](https://gitlab.com/gitlab-da/use-cases/ai/ai-workshops/gitlab-duo-ai-eddie-jaoude/getting-started-exercises), [2024-07-01](https://gitlab.com/gitlab-da/use-cases/ai/ai-workshops/gitlab-duo-use-case-python-2024-07-10), [2024-08-21 Python app](https://gitlab.com/gitlab-da/use-cases/ai/ai-workshops/gitlab-duo-use-case-python-2024-08-21), [2024-10-01 best practices](https://gitlab.com/gitlab-da/use-cases/ai/ai-workshops/gitlab-duo-workshop-best-practices-advanced-use-cases-2024-10-01) |
| Build your own adventure with GitLab Duo - C++ observability tool and hardware sensors | GitLab Duo | Showcase, audience watching/engaging, Sales Proof-of-value workshops (60min + async content) | C++, observability, embedded, sensors, metrics | @dnsmichi | [2024-12-05 Build your own adventure - C++](https://gitlab.com/gitlab-da/use-cases/ai/ai-workshops/gitlab-duo-workshop-build-your-own-adventure-cpp-2024-12-05) |

{{% /details %}}

### Maintained documentation

Developer advocates authored and maintain the following documentation pages, with practical and technical examples aiding adoption and efficiency use cases.
@@ -222,12 +228,14 @@ Note: The demos can be run offline in the absence of internet connectivity. To d
- [Support Orbit / Knowledge Graph launch (demos, use cases, research) - FY27](https://gitlab.com/gitlab-com/marketing/developer-relations/developer-advocacy/developer-advocacy-meta/-/work_items/1163)
- [Support GitLab DAP launch: Status, feature tracker, enablement - DevRel FY27](https://gitlab.com/gitlab-com/marketing/developer-relations/developer-advocacy/developer-advocacy-meta/-/work_items/878)

Archive:
{{% details summary="Archive" %}}

- [FY26 GitLab Duo (AI/ML) Adoption strategy (DevRel)](https://gitlab.com/groups/gitlab-com/marketing/developer-relations/-/work_items/520)
- [FY25 GitLab Duo adoption - Developer Relations epic](https://gitlab.com/groups/gitlab-com/marketing/developer-relations/-/epics/475) (internal).
- [FY25 CI/CD adoption - Developer Relations epic](https://gitlab.com/groups/gitlab-com/marketing/developer-relations/-/epics/466) (internal)

{{% /details %}}

### Projects

Source code, demo projects, workshops, tutorials, research, etc. are documented in the [Projects handbook](/handbook/marketing/developer-relations/developer-advocacy/projects/). This includes use cases for GitLab Duo (AI), CI/CD components, DevSecOps and Security, Workspaces, GitLab API, etc.
+9 −7
Original line number Diff line number Diff line
@@ -284,21 +284,21 @@ Example projects:

The [AGENTS.md standard](https://docs.gitlab.com/user/duo_agent_platform/customize/agents_md/) is similar to custom rules. It supports root and sub-directory-level AGENTS.md files, guiding and instructing agentic AI on how to navigate and use a specific project or directory.

Example projects:
Example environments:

- [Tanuki IoT Platform](https://gitlab.com/gitlab-da/use-cases/ai/gitlab-duo-agent-platform/demo-environments/tanuki-iot-platform/-/blob/main/AGENTS.md?ref_type=heads)
- [Tanuki IoT platform](https://gitlab.com/gitlab-da/demo-environments/tanuki-iot-platform)

### Custom Rules

**Consider adding custom rules by default to every new or existing Developer Advocacy project.**

1. Custom rules for [Agentic Chat](https://docs.gitlab.com/user/gitlab_duo_chat/agentic_chat/#create-custom-rules).
2. Custom review instructions for [Code Review Agent](https://docs.gitlab.com/user/project/merge_requests/duo_in_merge_requests/#customize-instructions-for-gitlab-duo-code-review).
3. System prompt for [custom agents in the AI Catalog](https://docs.gitlab.com/user/duo_agent_platform/agents/custom/).
1. [Custom rules](https://docs.gitlab.com/user/duo_agent_platform/customize/custom_rules/)
2. Custom review instructions for [Code Review Flow](https://docs.gitlab.com/user/duo_agent_platform/customize/review_instructions/).
3. System prompt for [custom agents in the AI Catalog](https://docs.gitlab.com/user/duo_agent_platform/agents/custom/)

Example projects:
Example environments:

- [Tanuki IoT platform](https://gitlab.com/gitlab-da/use-cases/ai/gitlab-duo-agent-platform/demo-environments/tanuki-iot-platform/-/tree/main/.gitlab/duo?ref_type=heads)
- [Tanuki IoT platform](https://gitlab.com/gitlab-da/demo-environments/tanuki-iot-platform)

### MCP Clients

@@ -314,6 +314,8 @@ Refer to the [GitLab MCP Server documentation](https://docs.gitlab.com/user/gitl

Follow the [Orbit documentation](https://docs.gitlab.com/orbit/) for setup and integration steps.

The [Orbit GA product epic](https://gitlab.com/groups/gitlab-org/-/work_items/19744) tracks the development and feature roadmap.

### Self-hosted models for Duo Agent Platform

Access to supported self-hosted models requires access to the engineering test infrastructure. Review the [self-hosted models research in FY26 (internal)](https://gitlab.com/gitlab-com/marketing/developer-relations/developer-advocacy/developer-advocacy-meta/-/issues/595#relevant-issues-epics-or-resources) for DRIs, options and ideas.
Loading