StackOverflow の活用
ここでは、質問する、回答する、ナレッジ記事/How-to ガイドを書く、Stack Overflow のコンテンツから GitLab Docs を改善する、といったプロセスを説明します。
質問する
Stack Overflow のトレーニングを参照してください。
- Slack and Stack Overflow
- Questions and Answers
- Overflow AI- Auto Answer in Slack
- General User Enablement (Stack)
- 質問のある人はSME (Subject Matter Expert) Slack チャネルのいずれかで質問してください。
- 質問するには
/stack askプロンプトを使用します。 - プロンプト
/slack askなしで質問された場合、別の SA や CSM が Slack で質問するように促すか、Slack 上のコンテンツを選択して Stack Overflow アプリで質問として作成できます。- TBD: 質問されたタイミングで Slack ボットを実行し、
/slack searchを起動して Stack の回答を Slack スレッドで提供することが可能です。
- TBD: 質問されたタイミングで Slack ボットを実行し、
- Stack Overflow が SA または CSM に必要なデータ (Title、Body、Tags) の入力を促します。
- Stack が質問が投稿されたことを確認します。
- Stack Overflow AI は Stack Overflow KB リポジトリを検索し、SA がアップボートまたは受諾するための回答を、元の質問のスレッドとして Slack に 1 つ以上返します。
- SA または CSM が回答を受諾すると、元の質問のスレッドとして Slack に表示されます。
- 回答が見つからなかった場合、Stack Overflow は Slack チャネルにリンクと元の質問を提示します。
- 他の SA はリンクを確認し、StackOverflow で追加の回答を提供できます。
- ナレッジは最終的に Stack Overflow レジストリにキャプチャされます。
flowchart TD
A[SA or CSM has question] --> B[They go to SME Slack channel]
B --> C{Used /stack search?}
C -->|Yes| D[Stack Overflow searches for answers]
C -->|No| E{Used /stack ask?}
D --> F{Answers found?}
F -->|Yes| G[User selects best answer]
G --> H[Answer displayed in Slack]
H --> Z[Knowledge utilized]
F -->|No or not satisfactory| E
E -->|Yes| J[User enters data: Title, Body, Tags]
E -->|No| I[Another SA nudges to use /stack ask]
I --> E
J --> K[Stack confirms question posted]
K --> L[Stack Overflow AI searches KB repository]
L --> M{Answers found?}
M -->|Yes| N[AI returns answers for upvoting/acceptance]
N --> O[User reviews and accepts answers]
M -->|No| P[Stack provides link to question]
P --> Q[Question presented back in original Slack channel]
Q --> R[Other SAs view and provide answers]
O --> S[Knowledge captured in Stack Overflow registry]
R --> S回答を提供する
回答にアップボートする
ナレッジ記事/How-to ガイド/ベストプラクティスを書く
Stack Overflow のトレーニングを参照してください。
SME プログラムのゴールの 1 つは、アーキテクチャブループリント、ベストプラクティス、ナレッジガイドの提供と作成によって、SA と CSM の専門性を高めることです。
アーキテクチャブループリントとベストプラクティスには 2 種類の考慮事項があり (StackOverflow KB のフォーカスは 1 種類のみ):
プラットフォームチーム/プロデューサー採用の考慮事項: 通常、Professional Services や Support Engineer のフォーカスです。これには次が含まれます。
- 大規模なデプロイメントアーキテクチャ/統合
- 大規模な構成
- デプロイメント/マイグレーション
- 大規模な継続的マネジメント/管理
- モニタリング、アラート、監査
大規模デプロイメント(設定、マイグレーション、管理、モニタリング、ブレイクフィックス)に関するベストプラクティスは、Support Engineer によってまたは Support Engineer のために書かれることが多く、Zendesk KB に存在します。
コンシューマー採用/成熟度の考慮事項: 通常、Customer Success、Solutions Architect、Professional Services のフォーカスです。これには次が含まれます。
- 概念アーキテクチャ/設計/データフロー
- サイジングおよびデプロイメント推奨への影響
- 大規模な新規ユーザー、ビジネスユニット、Infra、App のオンボーディング
- 大規模な採用管理
- Infra、App、Platform のデコミッション
- ユーザーオフボーディング
- 価値メトリクス
- モニタリング、オブザーバビリティ
SME、CSE、PSE などには、特に Stack Overflow 上での大規模採用に関して、上記についてのベストプラクティスを作成することを推奨します。
コレクションを作成する
Stack Overflow のトレーニングを参照してください。
コレクションは複数のタグにまたがるフォルダのようなものだと考えてください。
TBD: SME を様々な SME 領域にオンボーディングするためにコレクションを使いたいと考えています。
(適切なタグに基づいた) 推奨コレクションは以下の周辺になります。
- 各 SME 領域: AI、Dedicated、App Sec、Agile Planning、CICD、Metrics & Observation
- 各バーティカル: Financials、Embedded DevOps、Telecommunications
実践コミュニティ (Communities of Practices)
Stack Overflow のトレーニングを参照してください。
(適切なタグに基づいた) 推奨される実践コミュニティは、以下のような製品フォーカスに沿ったものとするべきです。
- モダナイゼーション&アナリティクス
- AI
- コア DevOps ワークフロー
- セキュリティ&コンプライアンス
- プラットフォーム
- 競合
- 内部開発プラットフォーム
- プラットフォームエンジニアリング
bfd74782)