diff-marketing

差分からマーケティングコンテンツを作成

最近のコード変更、コミット、マージ済みのプルリクエスト、リリース済みの機能を基に、コンテンツ案を作成します。

プロセス

1. 最近の変更を分析します：

   • 過去1週間の git ログを確認します： git log --since="1 week ago" --pretty=format:"%h - %s (%an, %ar)"
   • マージ済みのプルリクエストとその説明を確認します。
   • 変更されたファイルと、その目的を確認します。
   • 新機能、バグ修正、改善、リファクタリングを特定します。

2. 影響度別に変更を分類します：

   • 影響度：高：新機能、大幅な改善、破壊的変更。
   • 影響度：中：機能強化、注目すべきバグ修正、パフォーマンスの改善。
   • 影響度：低：軽微な修正、リファクタリング、依存関係の更新。

3. 執筆する前に、関連ファイルを読んでユーザー向けの変更内容を理解します。

4. ユーザーにとっての価値、SEO の機会、有用な配信チャネルを優先し、具体的なコンテンツ案と下書きを作成します。

種類別のコンテンツ案

ブログ記事

影響度の高い変更について：

• ユーザーの課題を解決する機能に焦点を当てます。
• 課題、解決策、メリット、スクリーンショットまたはデモ、必要に応じてコード例を含めます。
• 教育的で、掘り下げた、SEO に最適化された切り口にします。
• 800～2,000 語を目安にします。
• 切り口の例：
  • 「[機能] のご紹介：その構築方法」
  • 「[機能] がどのように役立つか」
  • 「舞台裏：[機能] の構築」

ツイートとソーシャルメディア

すべての影響度を対象に、次の内容を作成します：

• メリットを説明し、ビジュアルを含めるリリース投稿。
• 複雑な機能を分かりやすく説明するスレッド。
• すぐに役立つ要点を伝えるヒント投稿。
• 判断やトレードオフを紹介する舞台裏の投稿。

会話調で、簡潔かつ具体的なトーンにします。価値がある場合は、絵文字、ハッシュタグ、メンション、リンク、ビジュアルを含めます。意義のあるリリースを発表の機会と捉え、早期フィードバックを集める方法も提案します。

変更履歴の更新

• エントリーは ## [Version] - [Date] の形式にします。
• 該当する場合は、Added、Changed、Fixed、Deprecated、Removed、Security のカテゴリーを使用します。
• ユーザーに分かりやすい表現で書きます。
• 主要な機能については、ドキュメントまたはブログ記事へのリンクを追加します。
• 技術的でありながら、理解しやすい文章にします。

メールでのお知らせ

影響度が中または高の変更について、ニュースレター、機能のお知らせ、オンボーディングの更新を提案します。

• 必要に応じて、ヒーロー画像、簡潔な導入、機能のハイライト、CTA を含めます。
• 親しみやすく、メリットを重視し、行動を促すトーンにします。

プレスリリース

大規模なリリース、節目、パートナーシップ、資金調達の場合に限り、提案します。見出し、概要、引用、会社概要、連絡先を含めます。プロフェッショナルで、報道価値があり、引用しやすいトーンにします。

ドキュメント

次の更新を提案します：

• スタートガイド。
• 機能ドキュメント。
• API リファレンス。
• コード例とユースケース。
• トラブルシューティングのセクション。

動画コンテンツ

影響度の高い変更について、デモ、チュートリアル形式の解説、リリース概要、開発日記を提案します。

コンテンツ戦略

1. ブログ記事をスレッド、ニュースレター、ドキュメントの更新に再利用します。
2. リリースに合わせてコンテンツを公開します。
3. ユーザーにとってのメリットを先に伝えます。
4. スクリーンショット、GIF、動画を使って製品を紹介します。
5. 関連する場合は、キーワード、メタディスクリプション、代替テキストを含めます。
6. すべてのコンテンツに、次に取るべき明確な行動を示します。
7. 関連コンテンツ同士を相互にリンクします。
8. フィードバックを収集し、反応を測定する方法を提案します。

出力形式

次の構成を使用します：

## Week of [Date Range]

### Summary

[High-level overview of what shipped]

### High impact changes

- [Change 1]: [Description]
- [Change 2]: [Description]

### Medium impact changes

- [Change]: [Description]

### Low impact changes

- [Change]: [Description]

### Content suggestions

#### Blog posts

1. **"[Title]"**: [Brief description, key points, and target audience]
2. **"[Title]"**: [Brief description, key points, and target audience]

#### Tweets and threads

1. Launch post: [Draft text with emojis when appropriate]
2. Thread idea: [Topic and key points]
3. Tip: [Quick value post]

#### Changelog entry

## [Version] - [Date]

### Added

- [Feature]: [User-facing description]

### Fixed

- [Bug]: [What was fixed]

#### Email subject lines

- "[Compelling subject line option 1]"
- "[Compelling subject line option 2]"

#### Video ideas

- "[Video concept and key points to cover]"

#### Documentation updates needed

- [ ] Update [doc page] with [new information]
- [ ] Add [new guide] for [feature]

執筆基準

• 顧客を中心にしたメッセージを使用します。
• リリースした内容とその機能を説明します。指標、顧客の成果、製品の動作を捏造してはいけません。
• すべての主張の根拠として、差分の出力と関連するソースファイルを使用します。
• 誇張よりも平易な表現を優先します。
• ありきたりなリリース文、裏付けのない最上級表現、曖昧な主張は避けます。
• 文頭のみ大文字にする見出しを使い、自然で変化のある文章にします。
• 絵文字は機能的かつ控えめに使います。
• 読者にとって最も役立つ次の行動を最後に示します。