Buuk の仕組み

Buuk は編集ゲート付きのヘルプセンター基盤です。コンテンツはワークスペースにあります。エディターが下書きし、整理し、レビューします。お客様が見るのは公開サイト、検索、Ask AI、ウィジェット上の公開ページだけです。

1. ワークスペースがドキュメントの単位

各ワークスペースには名前、スラッグ、ブランディング、メンバー、コレクションがあります。公開 URL は app.getbuuk.com/help/your-slug の形です。Growth では docs.yourproduct.com のようなカスタムホスト名を付けられます。

オーナーとエディターは公開できます。ビューアーはライブページを変えずにダッシュボードで下書きを読めます。

2. コレクションが公開サイトの構造

フルの docs サイト（これ）は 5 つのコレクションをオンにします。Customise → site profile で一部だけ有効にもできます。

セクションとフォルダはコレクションの下にあります。リーフ記事がページです。フォルダはサイドバーで折りたためるので、長いナビでもスキャンできます。

3. 下書き、プレビュー、それから公開

1. 記事を作成またはインポートします。保存は自動です。バージョン履歴が以前のスナップショットを残します。
2. Help center preview で公開レイアウトを確認します。プレビューは下書きを公開しません。
3. 文面の準備ができたら公開します。スラッグが変わらない限り URL は安定します。
4. 任意: 公開時刻を予約する、または誰かが ship する前に編集承認を必須にする。

未公開の作業は、読者向けの公開検索、ウィジェット、Ask AI に出ません。公開するまで下書きは内部として扱ってください。

4. AI は執筆アシスタントであり、公開者ではない

ダッシュボードの Ask Buuk は記事の下書き、セクションの書き換え、設定への案内ができます。提案された更新は、チケット、Slack スレッド、GitHub リリース、Linear の issue、ヒットしなかった検索、「役に立たない」フィードバックをレビューリストにします。

Accept は適用するか下書きを開きます。公開前に編集してください。ドキュメントがすでに正しければ Dismiss します。Buuk が提案を勝手に公開することはありません。

5. 公開ヘルプセンターがお客様の面

• 公開記事の横断検索
• それらの記事に根拠を置き、引用付きの任意の AI 回答
• 各ページの役に立った / 立たなかったフィードバック
• チェンジログのリアクションとコメント（Buuk ログイン不要）
• 検索、チャット、お知らせ、音声付きの任意の埋め込みウィジェット

6. アナリティクスがループを閉じる

レポートは閲覧と検索を示します。ヒットしなかった検索と未回答の Ask AI 質問は提案された更新になります。Doc health と Freshness は薄い、古い、未確認のページを示すので、次に何を書き直すかがわかります。

典型的な 1 週間

1. プロダクトを出す — アプリが変わります。GitHub リリース、チケット、Slack の質問はいつもどおり届きます。
2. 提案をレビュー — Suggestions を開きます。ドキュメントにすべきものを Accept し、残りはそのままにします。
3. 編集して公開 — エディターで書き直します。Preview を確認して公開します。Freshness と検索が漏れたものを拾います。

今見ているのは、そのループが Buuk 自身で回っているところです。この文面を編集するには、ダッシュボードの Articles から任意の記事を開いてください。