Usa il prompt
Aggiungi il tuo brief
Aggiungi qui sotto il tuo contesto. Verrà incluso nel prompt quando lo copi o lo scarichi.
Crea un sito web HTML responsivo usando lo stack esistente del progetto per [PROJECT] e [AUDIENCE]. L’attività è: homepage della documentazione.
Contenuti e struttura obbligatori
Organizza la guida introduttiva, i concetti, le guide alle attività, il riferimento API e la risoluzione dei problemi.
Usa [APPROVED_CONTENT] come fonte per nomi, date, dati, dichiarazioni e destinazioni. Elenca gli input mancanti prima di sostituire qualsiasi elemento. Se è necessaria una dimostrazione, indica che i contenuti sono fittizi. Non inventare citazioni di clienti, classifiche, loghi di partner o funzionalità del prodotto.
Direzione del design
Usa [BRAND_RULES] e il design system già selezionato nel progetto. Se non viene fornito alcun sistema, parti da questa direzione: avorio caldo, tipografia antracite e un unico accento verde acido discreto; spaziatura generosa e griglia asimmetrica. Mantieni coerenti i ruoli di tipografia, spaziatura e colore. Dai priorità all’attività rispetto agli elementi decorativi ed evita una raccolta generica di schede non correlate.
Preparazione dei contenuti
Elenca la prima attività che un nuovo utente dovrebbe completare, i prerequisiti, le versioni supportate e le effettive destinazioni della documentazione. Separa i tutorial dal materiale di riferimento prima di progettare la navigazione.
Layout e comportamento
Fornisci un punto di partenza chiaro per il percorso introduttivo, quindi organizza i contenuti più approfonditi in concetti, attività e materiale di riferimento. Mantieni visibile il contesto della versione quando il lettore lascia la homepage.
Verifica di accettazione specifica dell'attività
- Rendi evidente la prima attività da completare con successo e mantieni visibile il contesto della versione.
- Chiediti se un nuovo utente possa scegliere una guida iniziale senza conoscere la terminologia interna.
- Verifica una pagina rinominata, un risultato di ricerca mancante e un link specifico per una versione.
Implementazione e revisione
Mantieni il testo modificabile. Usa una struttura semantica, controlli descrittivi, un focus da tastiera visibile e stati vuoti/di errore appropriati. Verifica i layout stretti e ampi. Rispetta le preferenze per la riduzione del movimento. Mantieni il framework e le dipendenze esistenti del progetto; non sostituire lo stack senza segnalarlo. Restituisci i file modificabili e spiega eventuali comportamenti incompleti o input non supportati. Esamina questa attività specifica prima di proporre funzionalità aggiuntive.
Allegato di riferimento e obiettivo di ricostruzione
Allega reference.webp, incluso nel pacchetto scaricabile di questo prompt, insieme al prompt in OpenDesign. Crea un risultato modificabile con composizione e gerarchia simili; non incorporare l'intera immagine di riferimento come interfaccia finale. Mantieni i contenuti di progetto approvati e le regole del brand se sono in conflitto con le etichette fittizie dell'esempio. Se l'immagine manca o è illeggibile, richiedila invece di dichiarare fedeltà visiva.
Composizione e contenuti di riferimento
Usa il file reference.webp allegato come riferimento visivo per la homepage della documentazione. Prima di procedere, individua le aree principali dall’alto verso il basso, le relative larghezze e altezze, l’allineamento, la spaziatura, la gerarchia tipografica, i colori delle superfici, i bordi, le immagini e i componenti ricorrenti. Mantieni queste relazioni anziché sostituirle con un modello generico. Contenuti richiesti per l’attività: organizza la guida introduttiva, i concetti, le guide alle attività, il riferimento API e la risoluzione dei problemi. Quando traduci l’immagine in elementi modificabili, segui queste indicazioni specifiche per il layout: fornisci un punto di partenza chiaro per il percorso introduttivo, quindi organizza i contenuti più approfonditi in concetti, attività e materiale di riferimento. Mantieni visibile il contesto della versione quando il lettore lascia la homepage.
Direzione visiva dal brief di esempio
avorio caldo, tipografia antracite e un unico accento verde acido discreto; spaziatura generosa e griglia asimmetrica.
Specifiche di interazione
Il riferimento è un concetto statico: il comportamento descritto di seguito è un requisito da implementare, non la prova che l’immagine sia già funzionante. Copia il prompt personalizzato nel progetto di lavoro. Inizia dall’attività principale: organizza la guida introduttiva, i concetti, le guide alle attività, il riferimento API e la risoluzione dei problemi. Rendi evidente la prima attività da completare con successo e mantieni visibile il contesto della versione. Per ogni controllo visibile, specifica l’evento di attivazione, lo stato interessato e il feedback; implementa le modifiche locali mantenendo uno stato coerente tra le viste correlate. Fai in modo che ricerca e filtri restituiscano risultati reali, che i controlli di selezione abbiano uno stato attivo esplicito e che le azioni di salvataggio mostrino, ove pertinente, un feedback visibile di operazione in corso, riuscita o non riuscita. Non aggiungere flussi di lavoro non pertinenti. Usa link appropriati per la navigazione, pulsanti per le azioni e nomi accessibili per i controlli a icona. Non indicare che un’operazione di backend è riuscita se è stata modificata soltanto una demo locale.
Confronto visivo e consegna
- Confronta il risultato con l'immagine allegata usando le stesse proporzioni. Prima di perfezionare i dettagli decorativi, verifica il posizionamento delle aree principali, le dimensioni relative delle immagini, le interruzioni di riga, la spaziatura, la gerarchia tipografica, il contrasto, gli stati attivi e la densità dei contenuti.
- Quindi testa il layout stretto senza comprimere il testo desktop in etichette minuscole.
- Mantieni loghi, foto e icone come risorse separate e tutte le etichette significative modificabili. Elenca eventuali caratteri o risorse non disponibili e qualsiasi scostamento intenzionale. Restituisci i file funzionanti insieme a una descrizione concisa dei comportamenti implementati e delle integrazioni ancora necessarie; non promettere un risultato identico al pixel basandoti solo sul prompt.
Scarica prompt + immagine
Include il prompt completo e l'immagine di riferimento a grandezza intera. Allega entrambi in OpenDesign per guidare il layout.
Come scrivere un prompt di progettazione per la homepage della documentazione
Usa questo prompt di progettazione per la homepage della documentazione per organizzare la guida introduttiva, i concetti, le guide alle attività, il riferimento API e la risoluzione dei problemi.
Il riferimento è un concept generato dall'IA. Le istruzioni seguenti descrivono cosa creare e testare; l'immagine non dimostra un comportamento funzionante.
Separa i percorsi di apprendimento dalla consultazione del materiale di riferimento
La documentazione serve sia a chi sta imparando un concetto sia a chi cerca informazioni su un’API specifica.
Riunire queste attività in un’unica griglia di link indifferenziata le rallenta entrambe. Fornisci un punto di partenza chiaro per il percorso introduttivo, quindi organizza i contenuti più approfonditi in concetti, attività e materiale di riferimento. Mantieni visibile il contesto della versione quando il lettore lascia la homepage.
Dal prompt
Fornisci un punto di partenza chiaro per il percorso introduttivo, quindi organizza i contenuti più approfonditi in concetti, attività e materiale di riferimento.
Personalizzalo
Raggruppa la guida introduttiva, i concetti, le guide alle attività, il riferimento API e la risoluzione dei problemi. Usa [TASK_LABELS] nelle descrizioni delle voci e mantieni un percorso diretto verso il materiale di riferimento.
Prepara i contenuti della homepage della documentazione
Cinque schede distinguono introduzione, concetti, guide operative, riferimento API e risoluzione dei problemi. Prepara destinazioni distinte per questi intenti anziché indirizzare ogni lettore verso un’unica lunga pagina.
Elenca la prima attività che un nuovo utente dovrebbe completare, i prerequisiti, le versioni supportate e le effettive destinazioni della documentazione. Separa i tutorial dal materiale di riferimento prima di progettare la navigazione.
Dal prompt
Organizza la guida introduttiva, i concetti, le guide alle attività, il riferimento API e la risoluzione dei problemi.
Personalizzalo
Per [PROJECT], usa [APPROVED_CONTENT] come fonte per questa homepage della documentazione. Elenca la prima attività che un nuovo utente dovrebbe completare, i prerequisiti, le versioni supportate e le effettive destinazioni della documentazione. Separa i tutorial dal materiale di riferimento prima di progettare la navigazione. Individua gli input mancanti prima di sostituirli con contenuti dimostrativi.
Segui il percorso di un nuovo utente e quello di un esperto
La sezione di avvio rapido passa dalla creazione di una chiave all’invio di una richiesta e alla visualizzazione di un risultato. Verifica che la guida collegata completi questa sequenza con un esempio concreto.
Un percorso dovrebbe condurre alla prima attività completata con successo; un altro dovrebbe portare a una voce API specifica senza dover rileggere l’introduzione. Chiediti se un nuovo utente possa scegliere una guida iniziale senza conoscere la terminologia interna. Verifica una pagina rinominata, un risultato di ricerca mancante e un link specifico per una versione.
Dal prompt
Rendi evidente la prima attività da completare con successo e mantieni visibile il contesto della versione.
Personalizzalo
Verifica la homepage della documentazione rispetto a questo requisito: rendi evidente la prima attività da completare con successo e mantieni visibile il contesto della versione. Chiediti se un nuovo utente possa scegliere una guida iniziale senza conoscere la terminologia interna. Verifica una pagina rinominata, un risultato di ricerca mancante e un link specifico per una versione. Conserva i contenuti approvati e modifica soltanto le parti che non superano questa verifica.
Verifica il risultato della homepage della documentazione
I testi generati, i percorsi e la struttura visiva devono essere sottoposti a revisione. Non collegare moduli, pagamenti o servizi esterni reali senza implementare e testare tali flussi.
- Chiediti se un nuovo utente possa scegliere una guida iniziale senza conoscere la terminologia interna. Verifica una pagina rinominata, un risultato di ricerca mancante e un link specifico per una versione.
Prompt di follow-up
Usalo dopo il primo risultato. Restringe la revisione alla parte più importante di questa attività.
Perfeziona l’attuale homepage della documentazione. Chiediti se un nuovo utente possa scegliere una guida iniziale senza conoscere la terminologia interna. Verifica una pagina rinominata, un risultato di ricerca mancante e un link specifico per una versione. Mantieni i contenuti approvati e la direzione visiva; modifica soltanto le parti necessarie per risolvere questi problemi.
