Usa el prompt
Añade tu encargo
Añade tu contexto a continuación. Se incluirá en el prompt cuando lo copies o descargues.
Crea un sitio web HTML adaptable mediante la estructura tecnológica existente del proyecto para [PROJECT] y [AUDIENCE]. La tarea es: página de inicio de la documentación.
Contenido y estructura obligatorios
Organiza la introducción, los conceptos, las guías de tareas, la referencia de la API y la solución de problemas.
Utiliza [APPROVED_CONTENT] como fuente de nombres, fechas, cifras, afirmaciones y destinos. Enumera los datos que faltan antes de sustituir cualquier elemento. Si se necesita una demostración, indica que su contenido es ficticio. No inventes citas de clientes, clasificaciones, logotipos de socios ni capacidades del producto.
Dirección de diseño
Usa [BRAND_RULES] y el sistema de diseño ya seleccionado en el proyecto. Si no se proporciona ningún sistema, empieza con esta dirección: marfil cálido, tipografía en color carbón y un único acento verde ácido discreto; espaciado generoso y una cuadrícula asimétrica. Mantén coherentes las funciones de la tipografía, el espaciado y el color. Da prioridad a la tarea sobre los elementos decorativos y evita una colección genérica de tarjetas inconexas.
Preparación del contenido
Enumera la primera tarea que debe completar un usuario nuevo, los requisitos previos, las versiones compatibles y los destinos reales de la documentación. Separa los tutoriales del material de referencia antes de diseñar la navegación.
Diseño y comportamiento
Proporciona un punto de partida claro para la ruta de introducción y organiza después el material más avanzado en torno a conceptos, tareas y referencias. Mantén visible el contexto de la versión cuando el lector abandone la página de inicio.
Comprobación de aceptación específica de la tarea
- Haz evidente la primera tarea que permite obtener un resultado satisfactorio y conserva el contexto de la versión.
- Pregúntate si un usuario nuevo puede elegir una guía inicial sin conocer la terminología interna.
- Prueba una página cuyo nombre haya cambiado, un resultado de búsqueda que no exista y un enlace específico de una versión.
Implementación y revisión
Mantén el texto editable. Utiliza una estructura semántica, controles descriptivos, un foco de teclado visible y estados vacíos o de error adecuados. Comprueba los diseños estrechos y anchos. Respeta las preferencias de movimiento reducido. Conserva el framework y las dependencias existentes del proyecto; no sustituyas la estructura tecnológica sin avisar. Devuelve los archivos editables y explica cualquier comportamiento incompleto o dato de entrada no compatible. Revisa esta tarea específica antes de proponer funciones adicionales.
Archivo de referencia y objetivo de reconstrucción
Adjunta reference.webp, incluido en el paquete de descarga de este prompt, junto con el prompt en OpenDesign. Crea un resultado editable con una composición y jerarquía similares; no incrustes la imagen de referencia completa como interfaz final. Conserva el contenido aprobado del proyecto y las reglas de marca si entran en conflicto con las etiquetas ficticias de ejemplo. Si la imagen falta o no se puede leer, solicítala en lugar de afirmar que existe fidelidad visual.
Composición y contenido de referencia
Usa el archivo reference.webp adjunto como referencia visual para la página de inicio de la documentación. Antes de crearla, identifica las regiones principales de arriba abajo, sus anchuras y alturas relativas, alineación, espaciado, jerarquía tipográfica, colores de superficie, bordes, imágenes y componentes repetidos. Conserva estas relaciones en lugar de sustituirlas por una plantilla genérica. Contenido obligatorio de la tarea: organizar la introducción, los conceptos, las guías de tareas, la referencia de la API y la solución de problemas. Sigue estas indicaciones de maquetación específicas de la tarea al convertir la imagen en elementos editables: proporciona un punto de partida claro para la ruta de introducción y organiza después el material más avanzado en torno a conceptos, tareas y referencias. Mantén visible el contexto de la versión cuando el lector abandone la página de inicio.
Dirección visual de los requisitos de ejemplo
marfil cálido, tipografía en color carbón y un único acento verde ácido discreto; espaciado generoso y una cuadrícula asimétrica.
Especificación de las interacciones
La referencia es un concepto estático: el comportamiento descrito a continuación es un requisito que debe implementarse, no una prueba de que la imagen ya funcione. Copia el prompt personalizado en tu proyecto de trabajo. Empieza por la tarea principal: organizar la introducción, los conceptos, las guías de tareas, la referencia de la API y la solución de problemas. Haz evidente la primera tarea que permite obtener un resultado satisfactorio y conserva el contexto de la versión. Para cada control visible, especifica su activador, el estado afectado y la respuesta; implementa cambios locales con un estado coherente en las vistas relacionadas. Haz que las búsquedas y los filtros ofrezcan resultados reales, que los controles de selección tengan un estado activo explícito y que las acciones de guardado muestren información visible de estado pendiente, éxito o error cuando corresponda. No añadas flujos de trabajo ajenos. Usa enlaces adecuados para navegar, botones para ejecutar acciones y nombres accesibles para los controles de iconos. No des a entender que una operación del backend se ha completado correctamente cuando solo ha cambiado una demostración local.
Comparación visual y entrega
- Compara el resultado con la imagen adjunta usando las mismas proporciones. Revisa la ubicación de las regiones principales, los tamaños relativos de las imágenes, los saltos de línea, el espaciado, la jerarquía tipográfica, el contraste, los estados activos y la densidad del contenido antes de perfeccionar los detalles decorativos.
- Después, prueba el diseño estrecho sin comprimir el texto de escritorio en etiquetas diminutas.
- Mantén los logotipos, las fotos y los iconos como recursos independientes y todas las etiquetas relevantes editables. Enumera las fuentes o los recursos no disponibles y cualquier desviación deliberada. Devuelve los archivos funcionales junto con una descripción concisa del comportamiento implementado y las integraciones pendientes; no prometas un resultado idéntico píxel a píxel basándote únicamente en el prompt.
Descargar prompt + imagen
Incluye el prompt completo y la imagen de referencia a tamaño completo. Adjunta ambos en OpenDesign para orientar la composición.
Cómo escribir un prompt de diseño para la página de inicio de la documentación
Usa este prompt de diseño para la página de inicio de la documentación a fin de organizar la introducción, los conceptos, las guías de tareas, la referencia de la API y la solución de problemas.
La referencia es un concepto generado por IA. Las instrucciones siguientes describen qué se debe crear y probar; la imagen no demuestra un comportamiento funcional.
Separa las rutas de aprendizaje de la consulta de referencias
La documentación sirve tanto a quienes están aprendiendo un concepto como a quienes buscan una API concreta.
Combinar esas tareas en una única cuadrícula de enlaces sin diferenciarlas ralentiza ambas. Proporciona un punto de partida claro para la ruta de introducción y organiza después el material más avanzado en torno a conceptos, tareas y referencias. Mantén visible el contexto de la versión cuando el lector abandone la página de inicio.
Del prompt
Proporciona un punto de partida claro para la ruta de introducción y organiza después el material más avanzado en torno a conceptos, tareas y referencias.
Personalízalo
Agrupa la introducción, los conceptos, las guías de tareas, la referencia de la API y la solución de problemas. Usa [TASK_LABELS] en las descripciones de las entradas y conserva una ruta directa al material de referencia.
Prepara el contenido de la página de inicio de la documentación
Cinco tarjetas separan los primeros pasos, los conceptos, las guías de tareas, la referencia de la API y la resolución de problemas. Prepara destinos distintos para estas intenciones en lugar de dirigir a todos los lectores a una única página larga.
Enumera la primera tarea que debe completar un usuario nuevo, los requisitos previos, las versiones compatibles y los destinos reales de la documentación. Separa los tutoriales del material de referencia antes de diseñar la navegación.
Del prompt
Organiza la introducción, los conceptos, las guías de tareas, la referencia de la API y la solución de problemas.
Personalízalo
Para [PROJECT], usa [APPROVED_CONTENT] como fuente de esta página de inicio de la documentación. Enumera la primera tarea que debe completar un usuario nuevo, los requisitos previos, las versiones compatibles y los destinos reales de la documentación. Separa los tutoriales del material de referencia antes de diseñar la navegación. Identifica los datos que falten antes de sustituirlos por contenido de demostración.
Sigue la ruta de un usuario nuevo y la de un experto
La franja de inicio rápido avanza desde la creación de una clave hasta la realización de una solicitud y la visualización de un resultado. Verifica que la guía enlazada complete esta secuencia con un ejemplo concreto.
Una ruta debe conducir a una primera tarea completada con éxito; otra debe llevar a una entrada concreta de la API sin tener que volver a leer la introducción. Pregúntate si un usuario nuevo puede elegir una guía inicial sin conocer la terminología interna. Prueba una página cuyo nombre haya cambiado, un resultado de búsqueda que no exista y un enlace específico de una versión.
Del prompt
Haz evidente la primera tarea que permite obtener un resultado satisfactorio y conserva el contexto de la versión.
Personalízalo
Revisa la página de inicio de la documentación conforme a este requisito: haz evidente la primera tarea que permite obtener un resultado satisfactorio y conserva el contexto de la versión. Pregúntate si un usuario nuevo puede elegir una guía inicial sin conocer la terminología interna. Prueba una página cuyo nombre haya cambiado, un resultado de búsqueda que no exista y un enlace específico de una versión. Conserva el contenido aprobado y revisa únicamente las partes que no superen esta comprobación.
Revisa el resultado de la página de inicio de la documentación
El texto generado, las rutas y la estructura visual requieren revisión. No conectes formularios reales, pagos ni servicios externos sin implementar y probar esos flujos.
- Pregúntate si un usuario nuevo puede elegir una guía inicial sin conocer la terminología interna. Prueba una página cuyo nombre haya cambiado, un resultado de búsqueda que no exista y un enlace específico de una versión.
Prompt de seguimiento
Úsalo después del primer resultado. Centra la revisión en la parte más importante de esta tarea.
Perfecciona la página de inicio actual de la documentación. Pregúntate si un usuario nuevo puede elegir una guía inicial sin conocer la terminología interna. Prueba una página cuyo nombre haya cambiado, un resultado de búsqueda que no exista y un enlace específico de una versión. Conserva el contenido aprobado y la dirección visual; cambia únicamente las partes necesarias para resolver estos problemas.
