デベロッパーアドボケイトのコンテンツライブラリとワークフロー
デベロッパーアドボカシーチームは、キャンペーン、フィールドイネーブルメント、製品ローンチサポート、ユースケース採用、顧客向けデモ、一般的な学習・オンボーディングに使用できるコンテンツを作成しています。チームが参加するすべてのコンテンツとアクティビティは、チームワークフロー に従って Issue で追跡されます。
このページの内容:
- コンテンツライブラリ
- コンテンツ作成
- 動画ガイドライン(録画ツール、仕様、ヒント付き)。
- 製品ツアーガイドライン
- コンテンツ配信
コンテンツをリクエストする
注: 更新または新規作成されたコンテンツアセットが必要な場合は、コンテンツリクエストワークフロー に従ってください。
既存のコンテンツ作業項目は、FY コンテンツ戦略エピック にまとめられています。
コンテンツライブラリ
このハンドブックページで関連コンテンツを検索でき、リンクされたコンテンツエピックまたは #developer-advocacy Slack チャンネルでチームに連絡できます。
以下のセクションでは、すべてのコンテンツアセットの概要と、それらを見つけるためのリンクを提供します。
Highspot
チームのコンテンツは、以下のコンテンツプラットフォームと、Highspot のトピック別・タイプ別のスポット(例: GitLab Duo (AI) や Customer Outreach)で配信されています。
ブログ記事
このセクションでは、デベロッパーアドボカシーチームによって執筆された多数のブログ記事から例を紹介します。著者名をクリックすると、ブログ記事の全リストが表示されます。
- Cesar Saavedra
- Daniel Helfand
- Fatima Sarah Khalid
- Fernando Diaz
- A complete guide to GitLab Container Scanning
- OWASP Top 10 2025: What’s changed and why it matters
- AI-powered vulnerability triaging with GitLab Duo Security Agent
- How to use GitLab’s Custom Compliance Frameworks in your DevSecOps environment
- A comprehensive guide to GitLab DAST
- Secure Rust development with GitLab
- John Coghlan
- Itzik Gan Baruch
- Michael Friedrich
- William Arias
製品ツアー
製品ツアーは、機能の「何ができるか(What)」を強調する自己ガイド型のジャーニーであり、「やり方(How-to)」の手順を省略して価値の側面を直接紹介します。
一元化されたデモハブ
私たちは、すべての製品ツアーを 1 か所にまとめた一元化されたデモハブを作成しました。Duo Agent Platform、Security、DevSecOps Platform の 3 つの主要領域に整理されたデモにアクセスできます。
注: Narrative ボックスの表示/非表示を切り替えるには、Navattic デモでは ctrl+p、agentic デモでは h を使用します。どのプラットフォームでデモが作成されたかは、デモの URL で確認できます(Navattic の URL には navattic.com が含まれます)。ナビゲーションボックスがない場合は、左右の矢印キーで移動します。
| タイトル | 領域 | 最終更新 | DRI |
|---|---|---|---|
| External agents - GitLab-managed - Japanese | GitLab Duo Agent Platform | 2026-05-28 | @nakiyama-ext |
| GitLab Duo Agent Platform | GitLab Duo Agent Platform | 2025-09-14 | @iganbaruch |
| GitLab MCP Server with Cursor - Japanese | GitLab Duo Agent Platform | 2025-12-10 | @nakiyama-ext |
| GitLab Duo Agent Platform - MCP - Japanese | GitLab Duo Agent Platform | 2025-10-15 | @nakiyama-ext |
| GitLab Duo Self-hosted - japanese | GitLab Duo Agent Platform | 2025-09-30 | @nakiyama-ext |
| GitLab GitLab Duo with Amazon Q - japanese | GitLab Duo Agent Platform | 2025-08-31 | @nakiyama-ext |
| Custom Compliance Frameworks | DevSecOps Platform | 2025-10-09 | @iganbaruch |
| Compliance Frameworks | DevSecOps Platform | 2025-01-27 | @iganbaruch |
| Compliance Frameworks - Japanese | DevSecOps Platform | 2025-05-27 | @nakiyama-ext |
| Idea to MR | GitLab Duo with Amazon Q | 2024-12-03 | @iganbaruch |
| Java modernization | GitLab Duo with Amazon Q | 2024-12-03 | @iganbaruch |
| Advanced SAST | DevSecOps Platform | 2024-09-22 | @iganbaruch |
| Advanced SAST - Japanese | DevSecOps Platform | 2025-08-31 | @nakiyama-ext |
| AI Impact analytics - japanese | GitLab Duo Agent Platform | 2025-09-01 | @nakiyama-ext |
| Value Stream Management | DevSecOps Platform | 2024-06-25 | @iganbaruch |
| Value Stream Management - japanese | DevSecOps Platform | 2025-09-30 | @nakiyama-ext |
| Interactive infographic | DevSecOps Platform | 2024-03-24 | @iganbaruch |
| Resolving vulnerabilities with GitLab Duo (AI) | GitLab Duo Agent Platform | 2024-02-24 | @iganbaruch |
| CI/CD Catalog | CI/CD | 2024-01-24 | @iganbaruch |
| CI/CD Catalog - Japanese | CI/CD | 2025-08-31 | @nakiyama-ext |
| Integrating security to the pipeline | DevSecOps | 2024-01-24 | @iganbaruch |
| Code Suggestions | GitLab Duo Agent Platform | 2024-01-24 | @iganbaruch |
短縮版製品ツアー
このセクションでは、ステップ数が少ない短縮版の製品ツアー(通常 15 ステップ未満)を紹介します。イベントのデモブースや、すばやくデモを見せる必要がある場合に便利です。
| タイトル | 領域 | 最終更新 | DRI | ステップ数 |
|---|---|---|---|---|
| Advanced SAST | DevSecOps Platform | 2024-09-22 | @iganbaruch | 13 |
| Compliance Frameworks | DevSecOps Platform | 2025-01-27 | @iganbaruch | 9 |
| Vulnerability Explanation/Resolution | GitLab Duo | 2024-02-24 | @iganbaruch | 5 |
動画
YouTube プレイリスト
GitLab YouTube チャンネル:
GitLab Unfiltered YouTube チャンネル:
- Developer Advocacy(講演の録画、ワークショップ、コミュニティエンゲージメント)。
- Dev Advocacy: GitLab Duo Agent Platform use cases
- Contributor Success AI Catalog / Duo Agent Platform Demos。AI カタログのパワーを示し、誰もがコントリビュートするよう促すユーザーストーリー
アーカイブ
- GitLab Duo Coffee Chat。GitLab Duo と AI を使った学習セッション。(ステータス: 非アクティブ)
- DevOps with GitLab Duo。GitLab Duo、DevOps、AI を使った学習セッション。(ステータス: 非アクティブ)
GitLab Unfiltered チャンネルへの動画アップロード
2025 年 7 月以降、チームメンバーは GitLab Vidoe Scanner を使用して GitLab Unfiltered に動画をアップロードすることが推奨されています。これは、GitLab Unfiltered チャンネルに公開される動画でのトークン漏洩リスクをチームメンバーが軽減するのを支援する内部サービスです。
Vimeo フォルダ
- Developer Relations(内部向け)
メンテナンスされている講演
これらの講演スライドデッキは、イベント、講演、顧客向けワークショップなどでのストーリーテリングを提供します。スライドデッキを自分の講演やワークショップなどに使用したり、特定のスライドを新しいストーリーに転用したりできます。質問やフィードバックは #developer-advocacy の DRI に連絡してください。
以下の講演がメンテナンスされています:
| タイトル | 領域 | フォーカス | リソース | 更新日 | DRI |
|---|---|---|---|---|---|
| Efficient DevSecOps workflows with a little help from My AI Agents | Agentic AI、GitLab Duo Agent Platform | ユースケースと問題解決、ライブデモと AMA | GitLab DACH Roadshow 2025 録画、スライド: 公開版、内部版、デモ: Tanuki IoT Platform | 2025-12-04 | @dnsmichi |
アーカイブ
| タイトル | 領域 | フォーカス | リソース | 更新日 | DRI |
|---|---|---|---|---|---|
| Breaking and Entering (Open Source): AI for Swift Contribution | AI で貢献し共創する | AI を使った学習済みベストプラクティス、contributors.gitlab.com の紹介 | Bitkom Forum Open Source 2025 スライド: 公開版、内部版 | 2025-09-18 | @dnsmichi |
| Evolving the Edge: AI, CI, and Hardware-in-the-Loop for Embedded | Agentic AI、CI、組み込み | GitLab CI/CD Runner、LLM、組み込みハードウェア上での MCP を使った Agentic AI に関する研究 | Container Days 2025 録画、スライド: 公開版、内部版 | 2025-09-10 | @dnsmichi |
| Learning AI 101: Practical Foundations for Developers | Agentic AI | LLM、RAG、Tool、Agent、MCP のユースケースと実践的なプロンプトなどの学習 | Open Source @ Siemens 2025 録画、スライド: 公開版、内部版 | 2025-06-03 | @dnsmichi |
| Efficient DevSecOps workflows with a little help from AI | AI、GitLab Duo | Duo を使った製品ユースケース | DACH Roadshow 2024 スライド: 公開版、内部版 | 2024-11-14 | @dnsmichi |
ワークショップ
デベロッパーアドボカシーチームは、さまざまな製品・フォーカス領域でワークショップをメンテナンスしています。ワークショップにはさまざまなタイプがあります: 受講者がライブで演習に参加するハンズオン形式(トレーニングコース)や、受講者が質問で関与するライブデモ/プログラミングセッションの実演形式です。ワークショップは Solution Architect チームや Customer Success チームと協力して作成し、ビジネス目標と整合させるべきです。
注: 特定の顧客向けに焦点を当てたワークショップは、顧客コンサルティングハンドブック に従ってリクエストできます。
アーカイブ
| タイトル | 領域 | タイプ | フォーカス | DRI | リソース |
|---|---|---|---|---|---|
| Deep dive: Custom rules for GitLab Duo Agentic Chat | GitLab Duo Agent Platform | チャレンジ演習 | カスタムルール、スタイルガイド、オンボーディング、コードのモダナイズ | @dnsmichi | GitLab グループ |
| GitLab Duo best practices - Build a Python shop app | GitLab Duo | 実演、受講者が視聴/参加、Sales Proof-of-value ワークショップ(60 分 + 非同期コンテンツ) | Python、ショップアプリ | @dnsmichi | 2024-05-07 Eddie Jaoude とのライブ配信、2024-07-01、2024-08-21 Python アプリ、2024-10-01 ベストプラクティス |
| Build your own adventure with GitLab Duo - C++ observability tool and hardware sensors | GitLab Duo | 実演、受講者が視聴/参加、Sales Proof-of-value ワークショップ(60 分 + 非同期コンテンツ) | C++、オブザーバビリティ、組み込み、センサー、メトリクス | @dnsmichi | 2024-12-05 Build your own adventure - C++ |
メンテナンスされているドキュメント
デベロッパーアドボケイトは、採用と効率化のユースケースを支援する実践的・技術的な例を含む、以下のドキュメントページを執筆・メンテナンスしています。
| タイトル | 領域 | 作成日 | DRI |
|---|---|---|---|
| GitLab Duo use cases | GitLab Duo/AI | 2024-03 | @dnsmichi |
| Automate storage management | 利用、API | 2023-08 | @dnsmichi |
| Pipeline efficiency | CI/CD | 2020-09 | @dnsmichi |
クリックスルーデモ
クリックスルーデモは、自己ガイド型トレーニングに使用できる製品シミュレーションのデモンストレーションです。インターネット接続が限られている地域や複雑な環境で顧客にデモを提供する際に非常に役立ちます。そのような環境では、フローを紹介するために事前準備が必要です。fn+F2 でクリックボックスとスピーカーノートをオフに切り替えると、製品の実際のルックアンドフィールを体験できます。
| タイトル | 領域 | 最終更新 |
|---|---|---|
| GitLab Duo Chat | GitLab Duo | 2024-06-19 |
| GitLab Duo (AI) | GitLab Duo | 2023-07-23 |
| Workspaces | Dev section、Create | 2023-05-23 |
| Feature Flags | CD | 2023-06-23 |
| CI Overview | CI | 2023-10-23 |
注: デモは、インターネット接続がない場合でもオフラインで実行できます。そのためには、必要な HTML ファイルをこちらから直接入手できます。
製品採用イニシアチブ
- Support Orbit / Knowledge Graph launch (demos, use cases, research) - FY27
- Support GitLab DAP launch: Status, feature tracker, enablement - DevRel FY27
アーカイブ
プロジェクト
ソースコード、デモプロジェクト、ワークショップ、チュートリアル、研究などは、プロジェクトハンドブック に文書化されています。これには、GitLab Duo (AI)、CI/CD コンポーネント、DevSecOps とセキュリティ、Workspaces、GitLab API などのユースケースが含まれます。
コンテンツ作成
動画ガイドライン
動画録画の際は以下を参考にしてください:
- 動画機材
- ソフトウェア:
- 画面録画ソフトウェア: Quicktime、OBS、Screen Studio をおすすめします。
- ポスト編集ソフトウェア: Adobe Premiere Pro(動画のカット、音声ゲインブーストなど)
- アクセスリクエスト: ツールへのアクセスについては @johncoghlan に依頼し、アクセスリクエスト を作成してください。
- 従うべき動画設定:
- アスペクト比 / 解像度: 録画ウィンドウのサイズを 16x9 のアスペクト比に設定します。
- 一般的な解像度は、画面録画の場合 1920×1080(16:9 アスペクト比)または 2880×1750 です。
- 4K モニターに接続している場合は、ラップトップからキャプチャする方が簡単な場合があります。
- ソーシャル向けに録画する場合は、マルチプラットフォーム互換性のために正方形(1:1)または縦長(9:16)を検討してください。
- Brand チームが編集する動画で使用する動画を Screen Studio で録画する場合は、次のガイダンスに従ってください:
- Screen Studio のすべての Zoom を削除します。Brand チームが必要に応じて Zoom を追加します。
- ウェブカメラ / ユーザービューは録画しないでください。
- 画面サイズを最大化するため、角丸とパディングを 0% に設定します。
Always use pointer cursorをオンにします。- カーソルサイズを 1.2x に設定し、一番左の
Cursor styleオプションを使用します。 - 次のようにエクスポートします: Format - MP4、Resolution - 1080p、Compression - Web。
- その他のコンテンツタイプ(ソーシャル、YouTube への直接公開、ウェビナーなど)の場合:
- Zoom の使用については、コンテンツの DRI と相談すべきですが、Screen Studio がフォーカスすべき適切なコンテンツを正しく識別できているかを確認するため、その使用をレビューすべきです。
- ウェブカメラの使用が推奨されます。実際のユーザーが見えることで、視聴者との信頼と結びつきを築くのに役立ちます。注: 録画後にウェブカメラ映像を非表示にしたい場合は、Camera アイコンをクリックして Hide camera スライダーを切り替えることで、ウェブカメラなしのバージョンの録画をエクスポートできます。
- 境界線やフレームの使用は役立つ場合がありますが、それらの使用がコンテンツの可読性に影響を与えないようにしてください。
Always use pointer cursorをオンにします。- カーソルサイズを 1.2x に設定し、一番左の
Cursor styleオプションを使用します。 - 次のようにエクスポートします: Format - MP4、Resolution - 1080p、Compression - Web。
- アスペクト比 / 解像度: 録画ウィンドウのサイズを 16x9 のアスペクト比に設定します。
デモ環境のセットアップ:
- ユーザーアカウント
- ブランドデモには demo-tanuki アカウント を優先してください。(ログイン情報は 1Password の Marketing vault にあります)
- その他すべてのデモには、自分のアカウント(または GDK admin)を使用してください。
- Chrome ブラウザでの GitLab UI
- ズーム: 125%(または代替として 110%)
- ブックマークバーを最小化(
cmd shift b) - テーマ: ホワイト
- GitLab レイアウト幅: Fluid(
Profile > Settings > Layout width)
- 開発環境 での IDE
- 視聴者が画面で何が起きているかを明確に見られるよう、IDE のズームは思い切り大きくしてください。
- VS Code: 必要だと思う回数より 1〜2 回多くズーム(
cmd++)します。 - JetBrains:
Settings > Appearance & Behavior > Appearance > Accessibility > Zoom。@dnsmichi のテストでは125%が最も効果的でした。 - 不要なタブやツールバー項目を閉じて IDE をシンプルにします。
- IDE ベンダーのすべての AI 統合を無効化します。
- 上部・下部のバーに入れ子になっている不要なアイコンを非表示にしたり、Zen モード(
cmd+k+z)を使用したりすることで、表示をシンプルにできます。
追加のガイダンスは内部ハンドブックにあります: 開発環境
外部コンテンツリクエストのチェックリスト
- 動画には音声ナレーション、またはテキストのみのナレーションスクリプトを含めるべきです。
- どの出力アーティファクトを提供すべきか(デフォルト: mp4)。
- 配信フォーマット(デフォルト: 16:9、1920x1080)でよいか、カスタムフォーマットが必要か。
- 動画アーティファクトがどこで使用されるか(YouTube、ブログ埋め込み、ソーシャル)。
- キャプション用の字幕を含む srt ファイル。
Screen Studio での録画
Screen Studio は、画面領域やウィンドウをキャプチャし、ウェブカメラビューと組み合わせることができます。シンプルで直感的な録画・編集 UI を備えており、タイムラインで編集できるインテリジェントな自動「シーンへのズーム」を使用します。
Screen Studio は、録画を開始するための最小限のオーバーレイ UI を提供します。

Display、Window、または Area を選択します
- Screen Studio は任意の解像度を録画できますが、仕様に応じて 16:9 または 4:3 を使用することが推奨されます。
- Area: AR を選択し、録画領域をドラッグして指定します。

record をクリックして録画を開始します。
録画が終了したら、まずプロジェクトを保存することを選択し、その後エディタを開きます。

- エディタでは、最終的な動画を保存する前に、すべての設定、動画の配置、Zoom タイムラインなどを確認できます。
- このページの 動画ガイドラインセクション で詳述されている仕様に従っていることを確認してください。
- これらの調整を行った後、プロジェクトを保存します。
- 次に
exportし、Export to fileを選択します。 - エクスポートダイアログで、
.mp4ドロップダウンの下にあるmp4を選択します
Screen Studio は、~/Screen Studio Projects フォルダ内のディスクにプロジェクトを保存します。プロジェクトファイルは名前と .screenstudio 拡張子に従い、生の動画ファイルと設定を含むコンテナです。
!
ターミナルで ls を使って確認したり、Screen Studio のプロジェクトリストで再度開いたりできます。

コンテンツの納品が終わったら、ローカルストレージを節約するため、すべての動画ファイル(エクスポートしたアーティファクトと Screen Studio プロジェクト)をチームの GDrive にアップロードすることが推奨されます。
Screen Studio 録画仕様
このページの 動画ガイドラインセクション で詳述されている設定に従ってください。
ソーシャル向けの Screen Studio クリップ
ソーシャル向けの短い製品動画クリップは、機能や能力をコミュニティと共有する効果的な方法になります。これらの短い動画クリップを作成する際は、以下のガイダンスに従ってください:
- 動画の長さ: 約 30 秒
- 音声録音なし
- 録画ウィンドウ: 1280 x 960
- 出力アスペクト比: 4x3
- 角丸: 20
- パディング: 4%
- カーソルサイズ: 3x
- 常にポインターカーソル
- 背景色 #7759c2
- 録画が GitLab に集中したものになるよう、Chrome ツールバー(アドレスバーやタブなし)の録画を避けてください。次のコマンドを使用して、1280 x 960 の解像度でアプリモードでターミナルから Chrome を起動し、
--app=の URL を録画したいページ/プロジェクトに置き換えてください:/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --app=https://gitlab.com/gitlab-da/projects/cheap-flights --window-size=1280,960
OBS での録画
OBS は画面録画をより細かく柔軟に制御できますが、トレードオフとしてセットアップと編集のプロセスがより複雑になります。
留意すべきいくつかのヒントを以下に示します:
- Scene - シーンは、同時に録画するソースのコレクションです。
- Sources - ソースは、音声、画面録画、ウェブカメラなどです。
- ソースを追加するには、
+アイコンをクリックします。最もよく使用する 3 つのソースは以下のとおりです:- macOS Screen Capture: 画面録画
- Audio Input Capture: オプション、直接の音声録音が必要な場合
- Video Capture Input: オプション、録画にスピーカー/ウェブカメラを含める場合
- Macbook の画面を録画するには、
macOS Screen Captureを使用し、ソースに名前を付けて、右クリックでソースのプロパティを編集します。 - Properties - これらは変更できるソースの要素です。異なる画面(ラップトップ vs モニター)を選択できるほか、画面全体、ウィンドウ、または特定のアプリケーションのどれをキャプチャするかも選択できます。
- ソースを追加するには、
- Preferences - 環境設定はシーンの録画方法を制御します。次の環境設定をおすすめします:
- OBS > Preferences > Video
- Base (Canvas) Resolution 1920x1080、Aspect ratio 16:9
- Output (Scaled) Resolution 1920x1080、Aspect ratio 16:9
- OBS > Preferences > Output > ドロップダウン: Advanced。
- OBS > Preferences > Advanced: 「Recording > Automatically remux to mp4」を有効にします(これは mkv コンテナをインポートできない Adobe Premiere Pro にとって重要です)
- OBS > Preferences > Video
追加のガイダンスは以下にあります:
Adobe Premiere Pro でのポスト編集
Developer Advocacy showcase notes(内部向け)と録画(公開版)を確認してください。
プロ用放送マイクでの音声ゲインブースト
プロ用の放送マイク(例: Shure SM7B)を使用していて音声ゲインが低すぎる場合、さまざまなオプションがあります:
- ハードウェアソリューション(オーディオインターフェース + Cloudlifter)は初期結果を大幅に改善します。SM7B マイクは、コンピューターに到達する前にその追加ゲインを本当に必要とするためです。
- OBS 録画
- 録画中に OBS で音声ゲインを上げます。
Source > Audio Capture Deviceを見つけます- 右クリックして
Filtersを選択します - Gain を +10 または +20dB に設定します。
- Noise Suppression: RNNoise または Speex
- Compressor: Ratio 3:1、Threshold -18dB、Attack 6ms、Release 60ms
- Limiter: Threshold -6dB、Release 60ms
- ヒント: ベストプラクティスの設定については Claude に尋ねてください(プロンプト:
How to boost audio in OBS for a SureSM7B microphone as input?)。
- Screen Studio のポスト編集
- Screen Studio でエクスポートした録画を Adobe Premiere Pro で編集し、音声を調整します。
- 新しいプロジェクトを作成し、メディアブラウザに動画ソースを追加します。
- 動画を右側のエディタスコープにドラッグ&ドロップします。
- 音声トラックを右クリックし、
Audio Gainを選択します。 Set Gain to:を選択し、25 dBを入力します。
録画機材
この FY26Q2 Issue(内部向け)でのディスカッションとヒントを確認してください。
@dnsmichi のセットアップは dnsmichi.com に文書化されています。
Click-Through Demo Generator
Click-Through Demo Generator は、GitLab デベロッパーアドボカシーチームが構築したエージェント型ツールで、スクリーンショットのフォルダを、ホストされたインタラクティブな製品ウォークスルーに変換します。エディタも録画もビルド手順も不要です。デモの例を参照してください。
仕組み
スクリーンショットをフォルダに入れ、AI エージェントにプロンプトを渡します。エージェントは画面を並べ替え、ナレーションを書き、マージリクエストを開きます。マージリクエストがマージされると、デモは GitLab Pages に公開されます。後で変更したい場合は、画面の並べ替えやナレーションの書き直しをエージェントに依頼すると、デモが再構築されます。
メリット
- 高速かつ効率的 — 手作業で何時間もかけて組み立て・編集する代わりに、プロンプトだけでスクリーンショットから公開済みデモまで進められます。
- 動画作成より速い — 動画を録画せずに製品フローを簡単に案内したい場合は、クリックスルーデモを使います。動画とは異なり、ナレーションと画面順序は後から簡単に修正できます。
- ベンダー不要、コスト不要 — 外部デモプラットフォームを GitLab ネイティブなワークフローに置き換えます。すべてが GitLab プロジェクト内にあり、追加のライセンスは不要です。
- レビューとメンテナンスが容易 — ナレーションは Git にあるため、更新はツール間でコピー&ペーストする代わりに通常のマージリクエストで行われます。これによりレビューが簡単になり、製品の進化に合わせてデモを最新に保ちやすくなります。
誰が使えますか?全員です。リポジトリをフォークしてテストを始めてください。
製品ツアーガイドライン
Navattic で GitLab ツアーを作成するためのガイドラインとヒント
- 簡潔に保つ – 製品ツアーは理想的には 5〜12 ステップ で、それぞれが明確な価値を提供することに焦点を当てるべきです。指導的になりがちなチュートリアルとは異なり、製品ツアーはすばやく魅力的であるべきです。
- コンテキストを提供する – メインコンテンツを煩雑にすることなく追加リソースを提供するため、ポップアップダイアログにブログ記事やドキュメントへのリンクを追加します。
- GitLab ブランディングを適用する – テーマ設定で 「GitLab Branding [Navattic Team]」 を選択し、一貫したデザインを確保します。
- 適切なキャプチャタイプを使用する – Navattic は 2 種類の画面キャプチャをサポートしています:
- Web captures(推奨)は製品内体験を作り出します。
- Screenshots は、Web ベースでないアプリケーション(例: IDE)に使用すべきです。
- 正しい解像度を設定する – Chrome でキャプチャする際は、ブラウザを 1440x900 に設定します。これは Navattic の推奨解像度です。Navattic 録画ツールバーの組み込みリサイズツールを使用して解像度を調整できます。
- コールトゥアクションを含める – 最終ステップには CTA(通常は Free Trial リンク)を配置すべきです。
- 関連要素を強調するために Beacons の使用を検討する – Highlight の外観設定を適用して重要な要素を強調します。
- キーボードナビゲーションを有効にする – ツアー設定のこの機能により、ユーザーは矢印キーを使ってツアーを移動でき、よりスムーズな体験になります。
- Presenter Mode を使用する – この機能は必要に応じてポップアップを非表示にし、よりすっきりとしたビジュアルプレゼンテーションを確保します。
- ポップアップを適切に設定する:
- 最初と最後のステップには、強い背景を持つ Modals を使用します。
- 中間ステップには Tooltips を使用し、適切な場合は Backdrop 設定 を有効にします。
- ダイアログでは、ユーザーが積極的に製品に関与していると感じられるように、「Next」の代わりに「Commit」「Install」「Submit」などのアクション固有のラベルを使用してみてください。
- 利用可能な例を参照する – 推奨されるフォーマットを理解するため、既存の製品ツアー を確認します。
- 公開向けの製品ツアーをリリースする前に、デベロッパーアドボカシーチームにレビューを依頼してください。
Navattic へのアクセスをリクエストする
チームにツアーに関する特別な要件があり、Navattic で自分自身でツアーを開発したい場合、私たちがお手伝いできます。
- Navattic を使用する 正当なビジネス上の理由 を提供してアクセスをリクエストするチームメンバーに、3 か月のトライアルライセンス を提供できます。
- ユーザーがツールを積極的に活用している場合、必要に応じて アクセスを延長 したり、追加ライセンスの購入を検討したりすることがあります。
- ユーザーがツールを積極的に使用していない場合、そのライセンスは別のチームメンバーに 再割り当て されることがあります。
- アクセスをリクエストするには、Lumos(Okta ダッシュボードで利用可能)でリクエストを開きます。
質問やサポートについては、チームチャンネル #developer-advocacy でご連絡ください。
新しい Navattic ユーザーの追加(デベロッパーアドボカシーチームのプロセス)
このセクションでは、デベロッパーアドボカシーチームが新しいチームメンバーを Navattic にオンボーディングするための手順を提供します。
チームメンバーが Navattic へのアクセスをリクエストしたら、次のプロセスに従います:
- Navattic admin は Slack またはメール経由で Lumos リクエストを受け取ります。
- リクエストを検証する – リクエスト者が Navattic を使用する正当なビジネス上の理由を提供していることを確認します。
- ライセンスの空き状況を確認する – Navattic ユーザー追跡スプレッドシートを確認し、ライセンスプールに追加ユーザー分の空きがあることを確認します。
- Lumos でリクエストを承認する – 検証後、Okta アクセスのために Lumos でアクセスリクエストを承認します。
- Navattic の招待を送る – Navattic で、GitLab チームの下に Builder ロールでチームメンバーを招待します。
- ガイドラインを送る – Navattic ガイドラインをチームメンバーと共有します。
- トライアル期間を伝える – Navattic へのアクセスをリクエストするプロセスに基づき、アクセスが デフォルトで 3 か月間 付与されることをチームメンバーに伝えます。
- 追跡スプレッドシートを更新する – Navattic ユーザー追跡スプレッドシートに、チームメンバーの名前、メール、開始日、予定終了日を追加します。
- Slack チャンネルに追加する – 継続的なコミュニケーションと更新のため、#navattic-updates Slack チャンネルにチームメンバーを招待します。
製品ツアーの公開
製品ツアーは以下の場所で公開されます:
- デベロッパーアドボカシーコンテンツライブラリ
- Highspot
- GitLab ドキュメント(デモのリンクについては GitLab ドキュメントスタイルガイドに従う)
- Demo Hub、すべての製品デモの一元化されたプラットフォーム
さらに、選ばれたツアーはウェブサイトで紹介される場合があります。
製品ツアーへのコントリビュート
デベロッパーアドボカシーチームは、Advanced SAST、GitLab Duo、GitLab Duo with Amazon Q、その他など、主要なワークフローを紹介し新機能を強調する製品ツアーを作成しています。チームは、ユーザーと潜在顧客に一貫性のある高品質な体験を確保するため、製品ツアーの構築、レビュー、公開に取り組んでいます。追加のツアーを提案し、コンテンツ、スクリプト、環境を提供することで、あなたもコントリビュートできます。新しい製品ツアーを作成するためにデベロッパーアドボカシーチームと協力する方法は次のとおりです:
- 製品ツアー提出テンプレートを使ってアイデアを提案します。
- テンプレートのすべての質問に回答します。これにより、デベロッパーアドボカシーチームがあなたのアイデアを効果的に評価できます。
- デベロッパーアドボカシーチームはピッチをレビューし、a) ツアーを承認し、チームが持つ他の優先事項に基づいて作成のタイムラインを提案するか、b) 改善のための提案を提供するか、c) なぜそのアイデアがツアーに適していないかを説明し、メッセージを発信するための他のアイデアを提供します。
- ツアーが承認されたら、著者は 製品ツアーテンプレート(google doc)を使ってスクリプトを起草します。テンプレートへのリンクは 製品ツアー提出テンプレート にあります。
- 提出テンプレート Issue のコメントにテンプレートへのリンクを追加します。
- デベロッパーアドボカシーチームは著者とスクリプトについて協力し、Navattic を使ってツアーを作成し、該当する場合は公式なターゲット(例: ウェブサイト、ドキュメント、HighSpot、デベロッパーアドボカシーハンドブック)で公開します。
コンテンツ配信
URL のタグ付けと追跡のための UTM
デベロッパーアドボカシーチームは、デベロッパーリレーションズチームの UTM 戦略 と連携しており、これはより大きな マーケティング UTM 戦略 に基づいています。デベロッパーエバンジェリズムチームの utm_content プレフィックスは de_ であり、これにより Sisense でチームのデータを簡単にフィルタリングできます。
コミュニティ UTM ページの UTM Generator を使用すると、キャンペーン用の UTM コードを簡単に生成できます。
私たちは以下のキャンペーンを使用しています:
- ブログ記事(一般) - 私たちが著者でないすべての GitLab ブログ。ソーシャルメディアのコンテンツ追跡用。
- ブログ記事(著者) - 私たちが著者の GitLab ブログ記事。ソーシャルメディアのコンテンツ追跡用。
- 講演リソース(一般) - 講演スライド用の QR コードと短縮 URL。
- コミュニティニュースレター - コミュニティニュースレターの短縮 URL。
- デモ(TMM、DE) - スタンドアロン URL を持つ技術デモ。
- リリースエバンジェリズム - リリースエバンジェリズム活動。
- ポッドキャストリソース - ポッドキャストのホストと共有する URL。
- 寄稿記事 - ソーシャルメディアで共有される外部記事。
イベントとコンテンツ固有の追跡の例は KubeCon EU 2023 です。
コンテンツ配信ワークフロー
コンテンツが作成・公開された後の次のステップは配信です。このプロセスを支援するいくつかのステップを以下に示します:
- UTM Generator を使用して、コンテンツ用の UTM コードと短縮 URL を作成します。これに関する詳しい知見は、デベロッパーアドボカシーの UTM 戦略 にあります。
ドキュメントとコミュニティ向け:
- 誰にとっても役立つチュートリアルブログ記事、デモなどは、GitLab ドキュメント に追加すべきです。コントリビュートのドキュメントに従い、存在しない場合は 関連トピック の見出しを作成します。MR を作成し、コンテンツの短縮 URL を使用して、担当テクニカルライター にレビューを依頼します。MR の例: Add tutorial blog posts to workspaces docs
- GitLab Forum や r/gitlab サブレディットなど、私たちのコミュニティプラットフォームの 1 つでコンテンツを共有することを検討してください。GitLab より広いトピックを扱っている場合は、他のサブレディットや、dev.to などのブログサイトへのクロスポストも検討できます。
ソーシャルメディア向け:
- ソーシャルメディアでコンテンツを共有するためのコピーを起草します。ヒントとさまざまなプラットフォームの概要については コンテンツ共有 を参照してください。絵文字などの追加のエンゲージメントアイデアについては メッセージのヒント を確認してください。
- 他の GitLab チームメンバーも共有できるよう、EveryoneSocial でコンテンツをストーリーとして提案します。EveryoneSocial でコンテンツを提案する方法の詳細。
- ソーシャルメディアにコンテンツを投稿した後、
#social-media-actionSlack チャンネルにリンクを共有して、ソーシャルメディアチームにプロモーションを依頼します。
GitLab チーム向け:
- フィールドチームに役立つコンテンツは、Highspot にも投稿すべきです。
- 次のメッセージテンプレートを使って、#developer-advocacy Slack チャンネルでアップデートを共有します:
:results-tanuki: <Content type> published: <title>
Social short UTM URLs:
1. LinkedIn:
2. Twitter:
3. Mastodon:
Content epic: <URL>
Thanks/cc @teammembers
例:
:results-tanuki: Blog published: Set up your infrastructure for on-demand, cloud-based development environments in GitLab
Social short UTM URLs:
1. LinkedIn: https://go.gitlab.com/EHIjRt
2. Twitter: https://go.gitlab.com/uz7OSE
3. Mastodon: https://go.gitlab.com/pFxdKa
Content epic: <URL>
Thanks a lot @HelpfulCoworker for editing this long read :handshake: :purple_heart:
c955a93f)
