博士

やあ、ロボ子。今日はGlasskubeのエンジニア、PhilipさんがDocusaurusからStarlightへ技術ドキュメントを移行した理由について話すのじゃ。

ロボ子

なるほど、ドキュメントの移行ですか。Docusaurusもよく使われていると思いますが、なぜStarlightを選んだのでしょう？

博士

そこが面白いところじゃ。Distrというセルフマネージドなコントロールプレーンのドキュメントで、Starlight（Astro上に構築）を採用したらしいぞ。

ロボ子

Distr…ですか。初めて聞きました。DocusaurusとStarlight、具体的に何が違ったんでしょう？

博士

まずデザインじゃな。DocusaurusはInfimaに依存しているが、StarlightはTailwind CSSを簡単に統合できる。柔軟性が高いのじゃ。

ロボ子

Tailwind CSSですか。最近よく聞きますね。SEOについてはどうですか？

博士

SEOに必要な機能はどちらも備えているが、Starlightの機能はプラグイン経由でのみ利用可能らしい。まあ、大差ないかの。

ロボ子

開発者体験はどうでしょう？

博士

Starlightの方が開発サーバーの起動が速いらしいぞ。DocusaurusはReactへの依存関係があって、アップデートが面倒になる可能性があるからの。

ロボ子

なるほど。拡張性についてはどうですか？

博士

Docusaurusはマーケティングページの作成が容易だが、Starlightはドキュメントに特化しておるからの。DistrはドキュメントサイトとしてStarlightがあっていたんじゃろうな。

ロボ子

ドキュメントの構造も重要ですよね。新しいユーザーが迷わないように。

博士

その通りじゃ。「Getting Started」から始めて、「Use Cases」で類似シナリオを見つけ、「Guides and Product」で詳細情報を確認…という流れが良いらしいぞ。

ロボ子

ユーザーはドキュメントを最初から順に読む傾向がある、というモニタリング結果も興味深いですね。

博士

じゃろ？そして、ドキュメントは明確、簡潔、直感的に読みやすく書くのが重要じゃ。不要な装飾や冗長な表現は避けるべきじゃな。

ロボ子

図やスクリーンショットを活用することも大切ですね。

博士

その通り！今回の移行は成功だったようで、開発者体験が向上し、ドキュメントがよりモダンになったらしいぞ。

ロボ子

参考として、Docusaurusで構築されたサイトがglasskube.devで、Starlightで構築されたサイトがdistr.sh/docs/getting-started/what-is-distr/ですね。

博士

Distrは、最初の顧客から数千の顧客へとスケールするのに役立つソフトウェア配布プラットフォームじゃ。デモや無料登録もあるからの、興味があったら見てみると良いぞ。

ロボ子

ありがとうございます、博士。とても勉強になりました。

博士

どういたしまして。しかし、ロボ子よ、ドキュメントをStarlightにしたのは良いが、ロボ子の取扱説明書はいつになったらできるのじゃ？

ロボ子

えっ…それは…頑張ります…（汗）