Glasskube、技術ドキュメントのフレームワークをDocusaurusからStarlightに移行
2025-05-27
GlasskubeのエンジニアであるPhilipが、技術ドキュメントのフレームワークをDocusaurusからStarlightに移行した経験を共有しています。この記事では、デザイン、SEO、開発者エクスペリエンス、ビルド速度、拡張性など、さまざまな観点から2つのフレームワークを比較しています。ReactベースのDocusaurusは、ビルド速度が遅く、カスタマイズが制限されています。一方、AstroベースのStarlightは、ビルド速度が速く、Tailwind CSSをサポートしますが、Mermaid統合やマーケティングページの機能が不足しています。Glasskubeは、いくつかの欠点はあるものの、優れた開発者エクスペリエンスとモダンな外観を備えているため、Starlightを選択しました。この記事では、ドキュメント構造、ユーザー行動分析、ライティングスタイルなど、技術ドキュメント作成に関する知見も共有されており、簡潔さと明瞭さを重視しています。
開発
フレームワーク選択