リリースノートとチェンジログ

リリースノートは、プロダクト変更の日付入りファーストパーティ記録です。何が出荷されたか、誰に影響するか、何が異なる動作をするか、ユーザーが次に何をすべきかを示します。チェンジログは、それらのエントリを時系列順に集めたものです。このフォーマットは、トラフィック資産である前に、リテンションツールです。顧客はこれを使って作業計画を立て、驚きを回避します。

基本ルールは祝福の前に結果です。リリースはチームにとってエキサイティングかもしれませんが、読者が最初に知る必要があるのは、自分のワークフロー、統合、データ、権限、価格、互換性が変更されたかどうかです。その結果を平易な言葉で述べてから、機能を説明します。SEO投稿タイプ システムにおいて、リリースノートはリテンションステージのサポートコンテンツです。その価値は、決して黙って書き換えられることのない永続的な記録から生まれます。

これが答える質問

完全なリリースノートエントリは、プロダクトの変更を見たり、見慣れない動作に遭遇した後に、既存ユーザーが抱く質問に答えます。

• 何が変更され、どのリリース日またはバージョンで変更されたか？
• 変更は今すぐ利用可能か、段階的に展開中か、ベータ版か、プラン、地域、プラットフォーム、アカウントタイプによって制限されているか？
• 管理者、エンドユーザー、開発者、パートナー、特定の統合など、誰が影響を受けるか？
• 以前の動作は何で、今は何が異なるか？
• ユーザーは移行、設定の更新、アクセスの再承認、同僚の再トレーニングを行う必要があるか、それとも何もする必要がないか？
• 変更は破壊的か、非推奨か、元に戻せるか、セキュリティに関わるか、保存データを変更する可能性があるか？
• 更新された手順、技術リファレンス、既知の制限事項、サポートルートはどこにあるか？
• 読者は自分のアカウントで新しい動作が有効になっていることをどのように確認できるか？

「改善」、「更新」、「効率化」などのラベルから読者に影響を推測させないでください。「エクスポートが改善されました」は宣伝的で検証不可能です。「CSVエクスポートに、適用された国とモデルのフィルターが2つの新しい列として含まれるようになりました。既存の列と順序は変更されていません」は、観察可能な変更とその互換性の範囲を定義しています。

この投稿タイプを使用するタイミング

イベントが出荷されたか、確固たる可用性状態にあり、プロダクト履歴に保存する価値のあるユーザーから見える違いが生じた場合にリリースノートを使用します。検索意図 は通常、ナビゲーショナルまたはインフォメーショナルです。読者はプロダクト名と「リリースノート」、バージョン番号、変更された機能、非推奨、または見慣れないインターフェースラベルを検索します。このフォーマットを、約束のバックログ、一般的なアナウンスフィード、またはタスクドキュメントの代わりとして使用しないでください。

変更に新しいインターフェースが必要なわけではありません。APIの動作、保持期間、計算、認証、フォーマット、制限、デフォルト、課金、アクセシビリティはすべてエントリを必要とする可能性があります。観察可能な結果のない内部リファクタリングは対象外です。

これらのビジネスタイプに最適

ランキングは、既存ユーザーとの日付入りの公開契約を維持する必要性を反映しています。

1. SaaS 。 継続的に配信されるインターフェース、API、権限、統合、プラン制限が顧客の訪問間で変更される可能性があるため、最も適しています。エントリには、展開状態、影響を受けるプラン、管理者への影響、ドキュメンテーションリンクを含める必要があります。
2. マーケットプレイス 。 1つのリリースが買い手、売り手、モデレーター、支払い受取人、パートナーに異なる影響を与える可能性があるため、価値が高いです。影響をセグメント化し、参加者固有の変更を普遍的なものとして提示しないでください。
3. Eコマース 。 アカウント、チェックアウト、サブスクリプション、返品、ロイヤルティ、配送、マーチャントツールの変更に有用です。ストアフロントの顧客への影響と、オペレーターまたは統合への影響を分けてください。特に支払いと注文状態に関して重要です。
4. 製造業および産業サプライヤー 。 ファームウェア、制御ソフトウェア、接続機器、技術ポータル、仕様改訂に重要です。バージョン、モデル互換性、安全境界、ロールバックの可否を明示する必要があります。
5. 金融、フィンテック、保険 。 価値は高いですが、レビューに多くの工数を要します。計算、適格性、開示、認証、データ処理の変更には規制上の結果が生じる可能性があるためです。管轄区域、承認、発効日、および置き換えられた動作を記録します。
6. B2Bサービス 。 サービスにメンテナンスされたプラットフォーム、方法論、データセット、クライアントポータル、または標準的なデリバラブルが含まれる場合に選択的に有用です。顧客契約やワークフローを変更しない限り、通常の会社ニュースは他の場所に属します。

検索意図

リリースノートの需要は、しばしば低ボリュームで高特異性です。クエリには、プロダクト名と「チェンジログ」、「最新バージョン」、「変更点」、「新しいダッシュボード」、APIバージョン、アップデート後に導入されたエラー、非推奨日などが含まれます。検索者は広範なプロダクトピッチを求めているわけではありません。権威あるタイムスタンプと、決定を下すのに十分な詳細を望んでいます。

有用な結果の形状は、プロダクト + バージョンまたは日付 + 変更 + 影響で始まります。これらの事実をタイトル、冒頭の要約、見出し、メタデータに配置し、すべてのマイナーエントリを個別のインデックス可能なURLに押し込まないでください。安定したアンカーにより、サポートチームとAI回答が1つのエントリを引用できます。リリースに相当な移行作業、特徴的な需要、または複数の関連変更がある場合は、専用ページが正当化されます。

リリースノートは、実際の変更をそれが発生するペースで公開するため、過小評価されているフレッシュネスシグナルです。これは、アクティブに見せるために日付を変更することを正当化するものではありません。エントリの日付、現在のドキュメンテーション、プロダクトの動作、移行ガイダンスは一致している必要があります。

ページ構造

ワードバンドは強調を設定するものであり、割り当て量ではありません。同じフィールド順序を維持し、読者が小さな修正と破壊的リリースの両方をスキャンできるようにします。

追加、変更、修正、非推奨、削除、セキュリティなどの安定したラベルで変更をグループ化しますが、ラベルが説明の代わりにならないようにしてください。「修正：エクスポート」は有用な記録ではありません。各項目は、以前の症状または制限、新しい観察可能な状態、影響範囲、および必要なアクションを明示する必要があります。

必須要素

配置はリスク管理の一部です。機能の宣伝の後に表示される移行警告は遅すぎます。

フロントマターと構造化データ

フロントマター仕様 に従ってください。このプレイブックページは entity = "post-type-release-notes" を使用しています。制作されたチェンジログは entity = "atlas-cloud-release-notes" のような安定したプロダクトとストリームの値を使用する必要があります。個別のリリースは entity = "atlas-cloud-2026-08" を使用できます。キャンペーンスローガンや変更可能なリリースタイトルを識別子として使用しないでください。

個別のリリースノートページには schemaType = "Article" を使用します。サイトがインデックスを別個のエンティティとして公開する場合、CollectionPage でそのインデックスを説明しつつ、各重要なエントリは日付入りの可視アイテムとして残ることができます。FAQが可視であり実装によってサポートされている場合のみ FAQPage を追加します。移行手順にステップが含まれているという理由だけで HowTo を使用せず、ページが文言を修正しただけなのにプロダクトが新しくリリースされたとマークしないでください。

リリース日は公開日および更新日とは別に保存します。推奨フィールドには、product、stream、version、status、releasedAt、platforms、plans、regions、affectedRoles、breakingChange、actionRequired、deprecationDate、owner、canonical URL、documentation targets が含まれます。段階的展開の場合は、1つのリリース日を保持し、期間を可視コピー内で明示します。

完全な例

以下の架空の例は、1つの重要なリリースを示しています。移行の結果を機能概要より先に配置し、安定したバージョンURLを使用しています。

+++
title = "Atlas Cloud 4.8 リリースノート — 2026年8月27日"
seoTitle = "Atlas Cloud 4.8 リリースノート：Export API移行"
entity = "atlas-cloud-4-8"
keywords = [ "Atlas Cloud 4.8", "Atlasリリースノート", "export API v2", "Atlasチェンジログ", "export移行", "Atlasプロダクトアップデート" ]
description = "Atlas Cloud 4.8は保存済みエクスポートビューとAPI v2を追加し、v1非推奨の期限を説明し、管理者にテスト済みの移行および検証パスを提供します。"
type = "academy"
date = "2026-08-27 10:00:00"
schemaType = "Article"
product = "Atlas Cloud"
version = "4.8"
releaseStatus = "rolling-out"
releasedAt = "2026-08-27"
platforms = [ "web", "API" ]
affectedRoles = [ "ワークスペース管理者", "統合オーナー" ]
breakingChange = true
deprecationDate = "2026-10-15"
+++

# Atlas Cloud 4.8 リリースノート

Atlas Cloud 4.8は2026年8月27日から展開を開始しました。保存済みエクスポートビューとExport API v2が追加されました。ワークスペースメンバーは既存のエクスポートを変更せずに保存済みビューを使用できます。API v1を使用している統合オーナーは2026年10月15日までに移行する必要があります。それ以降、v1のエクスポートリクエストはサポートされていないバージョンの応答を返します。

## アクション必須：Export API v1の移行

**影響を受ける対象：** `/api/v1/exports` にリクエストを送信する統合。ダッシュボードのエクスポートとAPI v2クライアントは影響を受けません。

**変更点：** v2では明示的な `format` 値が必要で、エクスポートジョブ識別子を `data.id` に返します。保存済みビューが異なるフィールドセットを選択しない限り、ファイルの列は変更されません。

**期限：** 2026年10月15日までに移行と検証を完了してください。既存のv1リクエストはそれまで引き続き動作します。

1. 現在のv1リクエストと同じフィルターでv2エンドポイントに対するテストリクエストを作成します。
2. 必要な `format` 値を追加し、ジョブ識別子を `data.id` から読み取ります。
3. 新旧のファイル間で行数、フィールドセット、タイムゾーン、既知のレコードを比較します。
4. 比較が成功した後にのみ本番環境を更新します。最初のスケジュールされた本番エクスポートが成功するまで、以前の設定を利用可能にしておきます。

テストが一致しない場合は、本番統合をv1のままにし、サニタイズされたリクエストID、タイムスタンプ、タイムゾーン、フィールドの不一致をサポートに送信してください。アクセストークンは含めないでください。

## 追加：保存済みエクスポートビュー

ワークスペース管理者は、名前付きのフィールドセット、フィルター、並び替え、ファイル形式を保存できます。エクスポート権限を持つメンバーはビューを再利用できます。ビューを保存しても、既に見ることができないレコードへのアクセスが許可されるわけではありません。

可用性を確認するには、**エクスポート → ビュー** を開き、**現在のビューを保存** を探してください。展開中はコントロールが表示されるまで最大3日かかることがあります。この機能はすべての地域のStandardおよびEnterpriseプランに含まれています。

## 修正：CSVファイルの国フィルターラベル

CSVエクスポートでは、フィルター概要列に内部の2文字値ではなく、表示される国名を使用するようになりました。これは概要ラベルのみを変更します。フィルタリングされたレコードと既存のデータ列は変更されていません。

## 既知の制限事項

保存済みビューはまだワークスペース間で転送できません。削除されたフィールドは、次回実行時にビューから削除され、エクスポート履歴にその省略が記録されます。

## 更新されたリソース

- Export API v2移行ガイド
- Export APIリファレンス
- エクスポート権限ドキュメンテーション
- エクスポートトラブルシューティング

この例は、テストされた互換性の範囲を示し、展開とリリース日を区別し、読者がアクセスを確認する方法を提供しています。

デザインギャラリー

すべてのレイアウトバリアントで同じリリース情報を維持し、デザインレビューが異なる編集上の決定ではなく階層をテストできるようにします。

品質チェックリスト

以下のすべての該当するステートメントが真である場合にのみ、リリースノートは準備完了です。

• タイトルと冒頭が、プロダクト、日付またはバージョン、主要な変更、影響を受ける対象を特定している。
• 可用性が正確である：出荷済み、期間付き展開中、ベータ、オプトイン、プラン制限、地域制限、延期、または撤回。
• すべてのエントリが「改善」、「強化」、「修正」に頼るのではなく、観察可能なbefore/afterの動作を説明している。
• 追加、変更、修正、非推奨、削除、セキュリティのラベルが一貫して適用されている。
• 破壊的変更はプロモーション上の利点より前に表示され、影響範囲、期限、障害モード、代替手段、移行、検証、ロールバックまたはサポートルートを明示している。
• 日付がリリース、公開、実質的な修正、非推奨、削除を区別している。
• バージョン識別子、エンドポイント名、メニューラベル、プラン、地域、プラットフォーム範囲が出荷状態に対して検証されている。
• 読者がアクションが必要かどうか、および完了を確認する方法を理解できる。
• 現在のドキュメンテーションが新しい動作を反映し、履歴が重要な場合に関連リリースにリンクバックしている。
• スクリーンショットにキャプチャ日またはバージョンと、表示されているコントロールまたは状態のテキスト代替がある。
• アーカイブが安定したURLまたはアンカー、最新優先のブラウジング、古いエントリに到達する方法を提供している。
• フロントマターFAQの回答と可視のFAQ回答が正確に一致し、分析がブラウジングと移行またはプロダクトアクションを区別している。

よくある間違い

記録ではなくキャンペーンコピーを書くこと。 「私たちはあなたのワークフローを変革できることに興奮しています」は事実を遅らせます。出荷された動作、対象、可用性、アクションで始め、ナラティブは別のローンチアナウンスに配置します。

破壊的変更を埋もれさせること。 スクリーンショットや利点の下にある移行期限は、回避可能な失敗を引き起こします。警告を最初に配置し、独立して理解可能にします。

展開をどこでもローンチと呼ぶこと。 一部のアカウントのみがアクセスできる場合は、展開と表現し、予想される期間を伝えます。まだ表示できないコントロールを説明する手順は、ユーザーの信頼を損なります。

「バグ修正と改善」を使用すること。 これは影響を受ける動作を隠し、ユーザーが自分の問題が解決されたことを認識できなくします。セキュリティ開示に抑制が必要でない限り、症状、範囲、新しい状態を明示します。

フレッシュネスのために日付を動かすこと。 タイプミスの修正で古いリリースが新しいものになるわけではありません。releasedAt を保持し、実質的な修正は別途記録し、可視記録が意味のある形で変更された場合のみ lastmod を使用します。

現在の手順を重複させること。 長いセットアップ手順は2か所で乖離します。リリースノートでは変更されたステップを要約し、メンテナンスされたドキュメンテーションに完全な現在のワークフローを任せます。

内部リンク

適切な内部リンク により、チェンジログはプロダクト知識の履歴レイヤーとなります。移行が変更された動作を説明する場合は、現在のドキュメンテーションからリンクします。リリースからは、ユーザーが必要とする正確なドキュメンテーション、移行、トラブルシューティング、ポリシー、または互換性ガイダンスにリンクします。

各重要な変更には1つの正規記録を使用します。ローンチ投稿、フィーチャーページ、サポート回答はそれを引用できますが、コピーしてはいけません。アーカイブナビゲーションは隣接するリリースとインデックスを接続する必要があります。非推奨の場合は、古いエントリをその代替手段にリンクし、移行ガイダンスを通知にリンクバックします。

結果の測定方法

ユーザーが適切な記録を発見し、影響を理解し、必要なアクションを完了し、明確化の必要性が減っているかを測定します。生のページビューは目標ではありません。小さな修正はトラフィックが少なくても目的を果たすことができます。

プロンプトトラッキング を使用して、プロダクト＋バージョンの質問、変更された機能名、非推奨日、「最新アップデート」の表現を追跡します。ソースおよび引用インテリジェンス を使用して、AI回答が正規エントリを引用し、可用性、影響範囲、期限、必要なアクションを保持しているかを検査します。AmICited Cockpit は、リリース関連の可視性と引用URLを、有機的なランディングアクティビティおよび選択されたプロダクトイベントと並べて表示できます。

公開前に、影響を受ける対象、展開期間、サポートボリューム、移行ベースライン、ターゲットクエリとプロンプト、成功を証明するイベントを記録します。以下をレビューします。

• プロダクト、バージョン、機能、非推奨、チェンジログのクエリに対するインプレッションと訪問数。
• 正しいリリース日、ステータス、互換性境界、アクションを再現するAI引用。
• チェンジログインデックスビューのみではなく、エントリレベルのアンカーまたはページビュー。
• 更新されたドキュメンテーション、移行、トラブルシューティング、または検証パスへのクリック。
• プライバシーセーフなテレメトリが存在する場合の移行開始、検証完了、残存するレガシー使用状況。
• 不明確な範囲、欠落した展開アクセス、または文書化されていない動作によって引き起こされたサポート問い合わせ。
• 修正、撤回、後続リリース、または期限変更後の古い回答。

結果の測定方法 に従って、発見、引用、エンゲージメント、タスク完了、リテンション、ビジネス成果を分離します。動きを解釈する前に、ローンチ、インシデント、キャンペーン、必須移行に注釈を付けます。トラフィックの急増は混乱を示す可能性があり、引用された回答が破壊的変更の期限を省略している場合は有害です。

FAQ

よくある質問