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.

Contenido que debes preparar
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.
Enfoque de diseño
Haz evidente la primera tarea que permite obtener un resultado satisfactorio y conserva el contexto de la versión.
Concepto visual generado por IA para la página de inicio de la documentación
Página de inicio de la documentación
Concepto visual generado por IA para la página de inicio de la documentación

Usa el prompt

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

  1. 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.
  2. Después, prueba el diseño estrecho sin comprimir el texto de escritorio en etiquetas diminutas.
  3. 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.

Descargar archivos

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.

Concepto visual generado por IA para la página de inicio de la documentación
Página de inicio de la documentación: compara la jerarquía general con las instrucciones de maquetación que aparecen a continuación.

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.

Puntos de entrada a la documentación según la intención en la referencia de la página de inicio de documentación
Puntos de entrada a la documentación según la intenció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.

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.

Secuencia de la primera tarea completada correctamente en la referencia de la página de inicio de documentación
Secuencia de la primera tarea completada correctamente.

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.

OpenDesign

Convierte tu prompt en un diseño.

Lleva el prompt y la imagen de referencia a OpenDesign. Añade tu contenido, crea la primera versión y perfecciona los detalles.

Descargar OpenDesign ↓
Pintura en tonos pastel de un lago azul, orillas verdes y un cielo iluminado por el sol de la página de inicio de OpenDesign.