コンテンツにスキップ

新しいヘルプサイトへようこそ!

なぜプラットフォームを変更したのか?

Section titled “なぜプラットフォームを変更したのか?”

このユーザーガイドは 2017 年から運用されてきました。この 7 年間、ユーザーと社内チームを支えてきましたが、一部のコンテンツに一貫性のなさ、不正確さ、情報の古さ、欠落があることも認識していました。レガシープラットフォームでは、一般公開される技術ドキュメントに携わるチームの規模が小さく、コラボレーションツールも限られていました。

Disguise では、私たちは急速にイノベーションを進めており、ドキュメントがそうした変化を反映し、ユーザーを支えるものである必要があります。

新しいサイトは Starlight というオープンソースのフレームワークを使って構築され、GitHub でソース管理されています。Starlight は Astro 向けのドキュメントウェブサイトフレームワークであり、Astro は人気の UI フレームワークで拡張できるウェブアプリケーション生成用のフレームワークです。

社内チームは、新しいブランチを追加し、GitHub でプルリクエストを作成することで、誰でも変更を提出できます。プルリクエストでは、変更がリポジトリの main ブランチにマージされる前に、レビュアーによる承認が必要です。新しいコンテンツが本番プロダクションブランチにプッシュまたはマージされると、自動デプロイがトリガーされます。プロダクションブランチがビルドされると、すべてのコンテンツがライブサイトに公開されます。

新しいプロセスはより高速で、Disguise 全体の専門家が、新しいコンテンツの執筆・レビュー・承認のいずれかを通じてドキュメントに協力できるようにします。