Utiliser le prompt
Ajouter votre cahier des charges
Ajoutez votre contexte ci-dessous. Il sera inclus dans le prompt lorsque vous le copierez ou le téléchargerez.
Créez un site web HTML responsive à l’aide de la pile technique existante du projet pour [PROJECT] et [AUDIENCE]. La tâche est la suivante : page d’accueil de la documentation.
Contenu et structure requis
Organisez la prise en main, les concepts, les guides pratiques, la référence API et le dépannage.
Utilisez [APPROVED_CONTENT] comme source pour les noms, dates, chiffres, affirmations et destinations. Dressez la liste des éléments manquants avant toute substitution. Si une démonstration est nécessaire, indiquez que son contenu est fictif. N’inventez aucun témoignage client, classement, logo de partenaire ni aucune fonctionnalité de produit.
Direction artistique
Utilisez [BRAND_RULES] et le système de conception déjà sélectionné dans le projet. Si aucun système n’est fourni, partez de cette orientation : ivoire chaud, typographie anthracite et une seule touche discrète de vert acide ; espacement généreux et grille asymétrique. Assurez la cohérence des rôles de la typographie, de l’espacement et des couleurs. Donnez la priorité à la tâche plutôt qu’aux éléments décoratifs et évitez un assemblage générique de cartes sans rapport entre elles.
Préparation du contenu
Indiquez la première tâche qu’un nouvel utilisateur doit accomplir, les prérequis, les versions prises en charge et les destinations réelles de la documentation. Séparez les tutoriels des ressources de référence avant de concevoir la navigation.
Mise en page et comportement
Donnez au parcours de prise en main un point de départ clair, puis organisez le contenu plus approfondi autour des concepts, des tâches et des ressources de référence. Gardez le contexte de version visible lorsque le lecteur quitte la page d’accueil.
Vérification d’acceptation propre à la tâche
- Mettez clairement en évidence la première tâche menant à un résultat et préservez le contexte de version.
- Demandez-vous si un nouvel utilisateur peut choisir un guide de démarrage sans connaître la terminologie interne.
- Testez une page renommée, un résultat de recherche manquant et un lien propre à une version.
Implémentation et vérification
Conservez le texte modifiable. Utilisez une structure sémantique, des contrôles explicites, un focus clavier visible et des états vides ou d’erreur appropriés. Vérifiez les mises en page étroites et larges. Respectez les préférences de réduction des animations. Préservez le framework et les dépendances existants du projet ; ne remplacez pas discrètement la pile technique. Livrez les fichiers modifiables et expliquez tout comportement incomplet ou toute donnée d’entrée non prise en charge. Vérifiez cette tâche précise avant de proposer des fonctionnalités supplémentaires.
Pièce jointe de référence et objectif de reconstruction
Joignez le fichier reference.webp du pack de téléchargement de ce prompt à ce dernier dans OpenDesign. Créez un résultat modifiable avec une composition et une hiérarchie similaires ; n’intégrez pas l’image de référence entière comme interface finale. Préservez le contenu approuvé du projet et les règles de marque s’ils entrent en conflit avec des libellés d’exemple fictifs. Si l’image est absente ou illisible, demandez-la au lieu de prétendre à une fidélité visuelle.
Composition et contenu de référence
Utilisez le fichier reference.webp joint comme référence visuelle pour la page d’accueil de la documentation. Avant de commencer, identifiez de haut en bas les principales zones, leurs largeurs et hauteurs relatives, l’alignement, l’espacement, la hiérarchie typographique, les couleurs de surface, les bordures, les images et les composants récurrents. Préservez ces relations plutôt que de les remplacer par un modèle générique. Contenu requis pour la tâche : organiser la prise en main, les concepts, les guides pratiques, la référence API et le dépannage. Suivez ces consignes de mise en page propres à la tâche lors de la transposition de l’image en éléments modifiables : donnez au parcours de prise en main un point de départ clair, puis organisez le contenu plus approfondi autour des concepts, des tâches et des ressources de référence. Gardez le contexte de version visible lorsque le lecteur quitte la page d’accueil.
Direction visuelle issue du projet de référence
ivoire chaud, typographie anthracite et une seule touche discrète de vert acide ; espacement généreux et grille asymétrique.
Spécifications des interactions
La référence est un concept statique : le comportement ci-dessous doit être implémenté et ne prouve pas que l’image est déjà fonctionnelle. Copiez le prompt personnalisé dans votre projet de travail. Commencez par la tâche principale : organiser la prise en main, les concepts, les guides pratiques, la référence API et le dépannage. Mettez clairement en évidence la première tâche menant à un résultat et préservez le contexte de version. Pour chaque contrôle visible, précisez son déclencheur, l’état concerné et le retour fourni ; implémentez les modifications locales avec un état cohérent dans les vues associées. Faites en sorte que la recherche et les filtres renvoient de vrais résultats, que les contrôles de sélection présentent un état actif explicite et que les actions d’enregistrement affichent, le cas échéant, un retour visible d’attente, de réussite ou d’échec. N’ajoutez aucun flux de travail sans rapport avec la tâche. Utilisez des liens appropriés pour la navigation, des boutons pour les actions et des noms accessibles pour les contrôles sous forme d’icônes. Ne laissez pas entendre qu’une opération côté serveur a réussi si seule une démo locale a été modifiée.
Comparaison visuelle et livraison
- Comparez le résultat à l’image jointe avec des proportions identiques. Vérifiez la disposition des principales zones, les dimensions relatives des images, les sauts de ligne, les espacements, la hiérarchie typographique, le contraste, les états actifs et la densité du contenu avant de peaufiner les détails décoratifs.
- Testez ensuite la mise en page étroite sans comprimer le texte de bureau dans des libellés minuscules.
- Conservez les logos, photos et icônes comme ressources distinctes, et tous les libellés porteurs de sens comme éléments modifiables. Répertoriez les polices et ressources indisponibles ainsi que tout écart intentionnel. Livrez les fichiers fonctionnels avec un compte rendu concis des comportements implémentés et des intégrations restantes ; ne promettez pas un résultat identique au pixel près à partir du seul prompt.
Télécharger le prompt + l’image
Inclut le prompt complet et l’image de référence en taille réelle. Joignez les deux dans OpenDesign pour guider la mise en page.
Comment rédiger un prompt de design pour la page d’accueil de la documentation
Utilisez ce prompt de design pour la page d’accueil de la documentation afin d’organiser la prise en main, les concepts, les guides pratiques, la référence API et le dépannage.
La référence est un concept généré par IA. Les instructions ci-dessous décrivent ce qui doit être créé et testé ; l’image ne démontre aucun comportement fonctionnel.
Séparez les parcours d’apprentissage de la consultation des références
La documentation s’adresse à la fois aux personnes qui découvrent un concept et à celles qui recherchent une API précise.
Réunir ces tâches dans une même grille de liens indifférenciée les ralentit toutes les deux. Donnez au parcours de prise en main un point de départ clair, puis organisez le contenu plus approfondi autour des concepts, des tâches et des ressources de référence. Gardez le contexte de version visible lorsque le lecteur quitte la page d’accueil.
À partir du prompt
Donnez au parcours de prise en main un point de départ clair, puis organisez le contenu plus approfondi autour des concepts, des tâches et des ressources de référence.
Personnalisez-le
Regroupez la prise en main, les concepts, les guides pratiques, la référence API et le dépannage. Utilisez [TASK_LABELS] dans les descriptions des entrées et préservez un accès direct aux ressources de référence.
Préparer le contenu de la page d’accueil de la documentation
Cinq cartes distinguent la prise en main, les concepts, les guides de tâches, la référence de l’API et le dépannage. Prévoyez des destinations distinctes pour ces intentions plutôt que d’orienter tous les lecteurs vers une seule longue page.
Indiquez la première tâche qu’un nouvel utilisateur doit accomplir, les prérequis, les versions prises en charge et les destinations réelles de la documentation. Séparez les tutoriels des ressources de référence avant de concevoir la navigation.
À partir du prompt
Organisez la prise en main, les concepts, les guides pratiques, la référence API et le dépannage.
Personnalisez-le
Pour [PROJECT], utilisez [APPROVED_CONTENT] comme source de cette page d’accueil de la documentation. Indiquez la première tâche qu’un nouvel utilisateur doit accomplir, les prérequis, les versions prises en charge et les destinations réelles de la documentation. Séparez les tutoriels des ressources de référence avant de concevoir la navigation. Identifiez les informations manquantes avant de les remplacer par du contenu de démonstration.
Suivre le parcours d’un débutant et celui d’un expert
La bande de démarrage rapide va de la création d’une clé à l’envoi d’une requête et à l’affichage d’un résultat. Vérifiez que le guide associé permet d’effectuer toute cette séquence à l’aide d’un exemple concret.
Un parcours doit mener à une première tâche réussie ; un autre doit permettre d’accéder à une entrée API précise sans relire l’introduction. Demandez-vous si un nouvel utilisateur peut choisir un guide de démarrage sans connaître la terminologie interne. Testez une page renommée, un résultat de recherche manquant et un lien propre à une version.
À partir du prompt
Mettez clairement en évidence la première tâche menant à un résultat et préservez le contexte de version.
Personnalisez-le
Évaluez la page d’accueil de la documentation selon cette exigence : mettre clairement en évidence la première tâche menant à un résultat et préserver le contexte de version. Demandez-vous si un nouvel utilisateur peut choisir un guide de démarrage sans connaître la terminologie interne. Testez une page renommée, un résultat de recherche manquant et un lien propre à une version. Préservez le contenu approuvé et ne révisez que les parties qui échouent à cette vérification.
Évaluer le résultat de la page d’accueil de la documentation
Les textes, les routes et la structure visuelle générés doivent être vérifiés. Ne connectez aucun formulaire réel, paiement ou service externe sans implémenter et tester ces parcours.
- Demandez-vous si un nouvel utilisateur peut choisir un guide de démarrage sans connaître la terminologie interne. Testez une page renommée, un résultat de recherche manquant et un lien propre à une version.
Prompt de suivi
Utilisez ceci après le premier résultat. Cela recentre la révision sur l’aspect le plus important de cette tâche.
Améliorez la page d’accueil actuelle de la documentation. Demandez-vous si un nouvel utilisateur peut choisir un guide de démarrage sans connaître la terminologie interne. Testez une page renommée, un résultat de recherche manquant et un lien propre à une version. Préservez le contenu approuvé et l’orientation visuelle ; ne modifiez que les parties nécessaires pour résoudre ces problèmes.
