最近、あるスマートフォン用アプリの案件を担当するようになりましたが、プッシュ通知が動かなくなるトラブルに遭遇しました。
この案件ではプッシュ通知の仕組みにGoogleのFirebase Cloud Messagingを使っています。

プッシュ通知を送信する場合、Firebase Cloud MessagingのAPIを使いますが、このAPIは新しいAPIに移行し、2023年に古いAPIはサポート対象外となりました。
サポート対象外になったことはFirebaseのドキュメントを見ればわかるのですが、これは2024年8月時点で英語版には掲載されていて、日本語版には掲載されていないです。

問題のページはこちらです。
https://firebase.google.com/support/faq

このページのCloud Messagingの箇所について、英語版と日本語版で比べてみました。
英語版

日本語版

英語版には FCM features deprecated in June 2023 の項目があり、サポート終了となるAPIを使っている開発者向けに今後どうすればよいかが記載されています。ところが日本語版にはFCM features deprecated in June 2023に相当する項目はありません。

また、APIの移行についての説明も違いがあります。
https://firebase.google.com/docs/cloud-messaging/migrate-v1

英語版

日本語版

英語版には古いAPIは2024年7月22日に停止すると記載がありますが、日本語版にはそういった記載はありません。
以下の記述が日本語版にはありません。

Sending messages (including upstream messages) with those APIs was deprecated on June 20, 2023, and shutdown begins on July 22, 2024.

つまり、日本語版のドキュメントだけ読んでいると古いAPIのサポートが終了となる重大な事実に気づけないのです。

そして、スマートフォンアプリの開発担当者は日本語版のドキュメントしか見ておらず、APIがサポート切れになっていることに気づけず、プッシュ通知が送信されてないというトラブルを引き起こしてしまいました・・・
このトラブルを解消するにはプッシュ通知の実装を新しいAPIに変える必要があります。すぐには変えられないので障害の長期化、顧客への謝罪、再発防止策の検討など大変なことになりました。

個人的な感覚ですが、海外ベンダーのドキュメントは英語版が最新だと思っております。安易に日本語版のドキュメントに頼るのではなく英語版のドキュメントを読んで開発した方がよいということです。