プロンプトを使う
制作要件を追加
以下に背景情報を追加してください。コピーまたはダウンロード時にプロンプトへ含まれます。
既存のプロジェクトスタックを使用し、[PROJECT]と[AUDIENCE]向けのレスポンシブなHTMLウェブサイトを作成してください。タスク:ドキュメントホームページ。
必須のコンテンツと構成
スタートガイド、概念、タスクガイド、APIリファレンス、トラブルシューティングを整理してください。
名称、日付、数値、主張、リンク先の情報源として[APPROVED_CONTENT]を使用してください。何かを代用する前に、不足している入力を列挙してください。デモが必要な場合、そのコンテンツが架空であることを明記してください。顧客のコメント、ランキング、パートナーロゴ、製品機能を捏造しないでください。
デザイン方針
[BRAND_RULES]と、プロジェクトですでに選択されているデザインシステムを使用してください。システムが指定されていない場合は、次の方向性から始めます。温かみのあるアイボリー、チャコールのタイポグラフィ、控えめなアシッドグリーンのアクセント1色、ゆとりのある間隔、非対称グリッド。書体、間隔、色の役割に一貫性を持たせてください。装飾要素よりもタスクを優先し、互いに無関係なカードを並べただけの汎用的な構成は避けてください。
コンテンツの準備
新規ユーザーが最初に完了すべきタスク、前提条件、対応バージョン、実際のドキュメントのリンク先を列挙してください。ナビゲーションを設計する前に、チュートリアルとリファレンス資料を分けてください。
レイアウトと動作
スタートガイドへの明確な出発点を設け、より詳細な資料を概念、タスク、リファレンス別に整理してください。読者がホームページを離れても、バージョン情報が見える状態を維持してください。
タスク固有の受け入れチェック
- 最初の成功タスクを明確にし、バージョン情報を維持してください。
- 新規ユーザーが内部用語を知らなくても開始ガイドを選べるか確認してください。
- 名前が変更されたページ、検索結果が見つからない場合、バージョン固有のリンクをテストしてください。
実装とレビュー
テキストは編集可能な状態にしてください。セマンティックな構造、内容が明確なコントロール、視認できるキーボードフォーカス、適切な空・エラー状態を使用してください。狭いレイアウトと広いレイアウトの両方を確認します。モーションを減らす設定を尊重してください。既存のプロジェクトフレームワークと依存関係を維持し、スタックを無断で置き換えないでください。編集可能なファイルを返し、未完成の動作や未対応の入力について説明してください。追加機能を提案する前に、この具体的なタスクをレビューしてください。
参考添付ファイルと再構築の目標
このプロンプトのダウンロードバンドルに含まれるreference.webpを、OpenDesign内でこのプロンプトと一緒に添付してください。構成と階層が似た編集可能な成果物を作成し、参考画像全体を完成インターフェースとして埋め込まないでください。架空のサンプルラベルと競合する場合は、承認済みのプロジェクトコンテンツとブランドルールを優先してください。画像がない、または読み取れない場合は、視覚的な忠実性を主張せず、画像の提供を依頼してください。
参考画像の構成とコンテンツ
添付のreference.webpをドキュメントホームページのビジュアルリファレンスとして使用してください。構築前に、上から下までの主要領域、相対的な幅と高さ、配置、間隔、タイポグラフィの階層、サーフェスカラー、境界線、画像、反復コンポーネントを特定してください。汎用テンプレートに置き換えず、それらの関係を維持してください。必須のタスク内容:スタートガイド、概念、タスクガイド、APIリファレンス、トラブルシューティングを整理すること。画像を編集可能な要素へ変換する際は、次のタスク固有のレイアウト指針に従ってください:スタートガイドへの明確な出発点を設け、より詳細な資料を概念、タスク、リファレンス別に整理します。読者がホームページを離れても、バージョン情報が見える状態を維持してください。
サンプルのプロジェクト需求に基づくビジュアル方針
温かみのあるアイボリー、チャコールのタイポグラフィ、控えめなアシッドグリーンのアクセント1色、ゆとりのある間隔、非対称グリッド。
インタラクション仕様
リファレンスは静的なコンセプトです。以下の動作は実装要件であり、画像がすでに動作することを示すものではありません。カスタマイズしたプロンプトを作業中のプロジェクトへコピーしてください。まず中核タスクに着手します:スタートガイド、概念、タスクガイド、APIリファレンス、トラブルシューティングを整理すること。最初の成功タスクを明確にし、バージョン情報を維持してください。表示される各コントロールについて、トリガー、影響を受ける状態、フィードバックを明示し、関連ビュー間で一貫した状態を保ちながらローカルな変更を実装してください。検索とフィルターには実際の結果を表示し、選択コントロールには明確なアクティブ状態を設け、保存操作には必要に応じて保留中/成功/失敗のフィードバックを表示してください。無関係なワークフローは追加しないでください。ナビゲーションには適切なリンク、操作にはボタンを使用し、アイコンコントロールにはアクセシブルな名前を付けてください。ローカルデモだけが変更された場合に、バックエンド操作が成功したかのように示さないでください。
ビジュアル比較と納品
- 同じ比率で成果物と添付画像を比較してください。装飾的な詳細を仕上げる前に、主要領域の配置、画像の相対サイズ、改行、余白、タイポグラフィの階層、コントラスト、アクティブ状態、コンテンツ密度を確認します。
- 次に、デスクトップ向けテキストを小さなラベルに無理に詰め込まず、狭いレイアウトをテストしてください。
- ロゴ、写真、アイコンは個別のアセットとして保持し、意味のあるラベルはすべて編集可能にしてください。利用できないフォントやアセット、および意図的に変更した点を列挙してください。動作するファイルに加え、実装した動作と未完了の連携について簡潔な説明を返してください。プロンプトだけでピクセル単位まで同一の結果を約束しないでください。
プロンプト+画像をダウンロード
完全なプロンプトとフルサイズのリファレンス画像が含まれます。レイアウトの参考として、両方をOpenDesignに添付してください。
ドキュメントホームページのデザインプロンプトの書き方
このドキュメントホームページ用デザインプロンプトを使用して、スタートガイド、概念、タスクガイド、APIリファレンス、トラブルシューティングを整理してください。
参考画像はAI生成のコンセプトです。以下の指示は、構築およびテストすべき内容を説明するものであり、画像は動作を実証するものではありません。
学習パスとリファレンス検索を分ける
ドキュメントは、概念を学ぶ人と特定のAPIを調べる人の双方に役立ちます。
それらのタスクを区別せず1つのリンクグリッドに混在させると、どちらも時間がかかります。スタートガイドへの明確な出発点を設け、より詳細な資料を概念、タスク、リファレンス別に整理してください。読者がホームページを離れても、バージョン情報が見える状態を維持してください。
プロンプトを活用
スタートガイドへの明確な出発点を設け、より詳細な資料を概念、タスク、リファレンス別に整理してください。
自分向けにカスタマイズ
スタートガイド、概念、タスクガイド、APIリファレンス、トラブルシューティングをグループ化してください。各エントリの説明には[TASK_LABELS]を使用し、リファレンス資料への直接の経路を維持してください。
ドキュメントホームページのコンテンツを準備する
5枚のカードで、はじめに、概念、タスクガイド、APIリファレンス、トラブルシューティングを分けています。すべての読者を1つの長いページに誘導するのではなく、それぞれの目的に応じた別々のリンク先を用意してください。
新規ユーザーが最初に完了すべきタスク、前提条件、対応バージョン、実際のドキュメントのリンク先を列挙してください。ナビゲーションを設計する前に、チュートリアルとリファレンス資料を分けてください。
プロンプトを活用
スタートガイド、概念、タスクガイド、APIリファレンス、トラブルシューティングを整理してください。
自分向けにカスタマイズ
[PROJECT]では、[APPROVED_CONTENT]をこのドキュメントホームページのソースとして使用してください。新規ユーザーが最初に完了すべきタスク、前提条件、対応バージョン、実際のドキュメントのリンク先を列挙してください。ナビゲーションを設計する前に、チュートリアルとリファレンス資料を分けます。不足している入力を特定してから、デモ用コンテンツに置き換えてください。
初心者とエキスパートのパスをたどる
クイックスタートの帯では、キーの作成からリクエストの送信、結果の確認へと進みます。リンク先のガイドで、具体例を使ってこの一連の手順を完了できることを確認してください。
一方の経路では最初の成功タスクに到達でき、もう一方では導入を読み直さずに特定のAPIエントリへ到達できるようにしてください。新規ユーザーが内部用語を知らなくても開始ガイドを選べるか確認してください。名前が変更されたページ、検索結果が見つからない場合、バージョン固有のリンクをテストしてください。
プロンプトを活用
最初の成功タスクを明確にし、バージョン情報を維持してください。
自分向けにカスタマイズ
次の要件に照らしてドキュメントホームページを確認してください:最初の成功タスクを明確にし、バージョン情報を維持すること。新規ユーザーが内部用語を知らなくても開始ガイドを選べるか確認してください。名前が変更されたページ、検索結果が見つからない場合、バージョン固有のリンクをテストしてください。承認済みコンテンツを維持し、この確認に合格しない部分だけを修正してください。
ドキュメントホームページの結果を確認する
生成されたコピー、ルート、ビジュアル構造にはレビューが必要です。実際のフォーム、決済、外部サービスは、それらのフローを実装してテストするまで接続しないでください。
- 新規ユーザーが内部用語を知らなくても開始ガイドを選べるか確認してください。名前が変更されたページ、検索結果が見つからない場合、バージョン固有のリンクをテストしてください。
フォローアッププロンプト
最初の結果を得た後に使用してください。このタスクで最も重要な部分に修正範囲を絞ります。
現在のドキュメントホームページを改善してください。新規ユーザーが内部用語を知らなくても開始ガイドを選べるか確認してください。名前が変更されたページ、検索結果が見つからない場合、バージョン固有のリンクをテストしてください。承認済みのコンテンツとビジュアル方針を維持し、これらの問題の解決に必要な部分だけを変更してください。
