Cloudflareは最近、HugoからAstroエコシステムに移行することで、開発者向けドキュメントをアップグレードしたことを詳細に説明する記事を公開した。すべてのCloudflareドキュメントはGitHubでオープンソース化されており、コミュニティによるコントリビューションの機会もある。
developers.cloudflare.comサイトは以前、複数のWorkers Sitesから単一のCloudflare Pagesインスタンスに統合されていた。このプロセスでは何千ものMarkdownページをHTML、CSS、JavaScriptに変換するためにHugoやGatsbyのようなツールを使っていた。Cloudflareのプロダクトコンテンツ責任者 Kim Jeske氏、Cloudflareのドキュメントプラットフォームエンジニア Kian Newman-Hazel氏、Cloudflareのテクニカルライティングマネージャー Kody Jackson氏が、Webフレームワーク変更の背景にある理由についてこう説明する：
Cloudflareのコンテンツチームは製品のローンチに合わせてドキュメントを提供するために規模を拡大してきましたが、オープンソースのドキュメントサイト自体はうまく追随できていませんでした。developers.cloudflare.comはコントリビューターのワークフローを超えてしまい、さらに私たちはコミュニティの開発者が作成した素晴らしいものを見逃し続けていました。
2021年、Cloudflareは「content like a product」戦略を採用し、ユーザーのニーズを予測し、アクセシブルな製品づくりをサポートするために、ワールドクラスのコンテンツの必要性を強調した。Jeske氏、Newman-Hazel氏、Jackson氏はこう書いている：
オープンソースドキュメントは誰でも、どこでも、コンテンツ開発に貢献できるため、開発者コミュニティに力を与えます。コンテンツとドキュメントサイトのフレームワークの両方を公開することで、開発者が資料自体を改善するだけでなく、ドキュメントがどのように構築され、承認され、維持されるかのプロセスを理解し、関与する機会を提供します。
チームによると、Astroのドキュメントテーマである「Starlight」は、ドキュメントサイトの移行を決定する上で重要な要素だった：このテーマは、強力なコンポーネントのオーバーライドと、組み込みコンポーネントと基本スタイルを利用するためのプラグインシステムを提供する。CloudZeroのリサーチディレクター Jeremy Daly氏はこうコメントしている：
Cloudflareはすべての開発者向けドキュメントをオープンソース化し、HugoからAstroに移行しましたが、これによりJavaScriptエコシステムがまた一つの犠牲者を出すことになりました。ドキュメントがどんなに優れていても、ユーザーフィードバックはそれを最新かつアクセシブルにし続けるためには不可欠です。
Cloudflareチームによると、すべてのドキュメントをオープンソースにすることで、同社はコミュニティとのつながりと迅速なフィードバックの迅速な実装を維持できるようになるとのことだが、これは他のハイパースケーラーではあまり見られない戦略だ。InfoQが以前報じたように、AWSは5年間ほとんどのドキュメントをオープンソースとして維持した後、そのアプローチを変更した。2023年、このクラウドプロバイダーは内部バージョンと一致させることの難しさやGitHubリポジトリとの同期に必要な手作業を理由に、全ての公開GitHubドキュメントを廃止した。当時、AWSのチーフエバンジェリスト Jeff Barr氏はこう書いている：
オーバーヘッドが非常に高く、実際にはドキュメントの品質を直接的に向上させるために使える貴重な時間を消費していました。
Mathi社のソフトウェアエンジニア Gianluca Arbezzano氏は、このトピックの重要性を強調する：
もしあなたが「ただのドキュメントだ」と思っているのなら、もう少し気にかけるべきだと思います！私たちは最高のものだけを求めています！CloudflareのHugoからAstroへの移行に関する記事は素晴らしいです。
Hacker NewsのCloudflare記事に対するコメントでAlex Hovhannisyan氏は警告する：
申し訳ありませんが、最近Netlifyから移行した（そして戻ることを検討している）者として正直に言わなければなりません：ドキュメントはあまり良くなく、あなた方の技術スタックには関係ありません。エンドユーザーはドキュメントにどんな技術スタックを使っているかなど気にしません。
すべてのCloudflareドキュメントはdevelopers.cloudflare.comで入手できる。