> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Revisión de documentos
> Recibe comentarios estructurados y prácticos sobre la estructura, claridad y completitud de tu documento.
La Revisión de documentos ofrece comentarios estructurados y prácticos sobre tu escritura. En lugar de hacerle preguntas generales al Asistente, la Revisión de documentos analiza tu documento completo y aporta ideas sobre estructura, claridad, completitud y calidad general.
Esto te ayuda a detectar problemas antes de compartir, mejorar la calidad del contenido y obtener una perspectiva externa sobre tu trabajo, todo sin salir de Craft.
## Qué hace la Revisión de documentos
La Revisión de documentos examina tu documento en varias dimensiones:
**Estructura y organización:**
* Flujo y progresión lógica
* Jerarquía y coherencia de encabezados
* Equilibrio y ritmo de secciones
* Arquitectura de la información
**Claridad y legibilidad:**
* Complejidad y longitud de las oraciones
* Uso de jerga y lenguaje técnico
* Transiciones entre ideas
* Puntuación general de legibilidad
**Completitud:**
* Contexto o antecedentes que faltan
* Lagunas en las explicaciones
* Preguntas sin respuesta
* Áreas que necesitan ampliación
**Señales de calidad:**
* Coherencia del tono
* Problemas de formato
* Redundancias y repeticiones
* Oportunidades de mejora
La revisión es objetiva, específica y práctica: obtienes sugerencias concretas, no comentarios vagos.
## Cómo iniciar una Revisión de documentos
Abre el documento que quieres revisar.
Haz clic en el icono del Asistente en la esquina inferior.
Selecciona **Nuevo chat**.
Elige **Revisión de documentos** en el selector de modo.
Espera a que se complete el análisis (normalmente entre 10 y 30 segundos).
El Asistente leerá tu documento completo y proporcionará comentarios estructurados organizados por categoría.
La Revisión de documentos funciona con todos los modelos, pero **Max** ofrece los comentarios más completos y matizados, especialmente para documentos largos o complejos. Para revisiones rápidas, **Fast** ofrece un buen equilibrio entre profundidad y velocidad.
## Revisión de documentos vs. chat general del Asistente
| Característica | Revisión de documentos | Chat general del Asistente |
| --------------------- | -------------------------------------------- | ---------------------------------------------------- |
| **Objetivo** | Comentarios estructurados sobre el documento | Conversación y tareas abiertas |
| **Alcance** | Análisis del documento completo | Responde preguntas específicas |
| **Formato de salida** | Organizado por categorías de comentarios | Respuestas conversacionales |
| **Profundidad** | Completo y multidimensional | Centrado en tu pregunta específica |
| **Ideal para** | Revisiones de calidad antes de publicar | Ediciones rápidas, resúmenes, consultas de contenido |
| **Seguimiento** | Puede hacer preguntas aclaratorias | Conversación continua |
| **Uso** | Mayor (analiza el documento completo) | Varía según la complejidad de la consulta |
Usa la **Revisión de documentos** cuando quieras comentarios completos sobre todo el documento. Usa el **chat general** cuando tengas preguntas o tareas específicas.
## Cuándo usar la Revisión de documentos
La Revisión de documentos es más valiosa en estos escenarios:
### Antes de compartir externamente
Revisa presentaciones, propuestas o documentos orientados al cliente para detectar problemas estructurales, secciones poco claras o contexto que falta antes de enviarlos.
### Control de calidad
Realiza revisiones periódicas de documentación importante, wikis de equipo o artículos de base de conocimiento para mantener alta calidad y consistencia a lo largo del tiempo.
### Mejora del contenido
Obtén sugerencias prácticas para entradas de blog, informes o redacción de formato largo. El Asistente puede identificar áreas que necesitan ampliación, simplificación o reestructuración.
### Preparación para la colaboración
Antes de compartir con compañeros, asegúrate de que tu documento sea claro, completo y bien organizado. Esto reduce el ir y venir y mejora la eficiencia de la colaboración.
### Aprendizaje y desarrollo de habilidades
Usa las revisiones para entender patrones en tu escritura: problemas recurrentes de claridad, tendencias estructurales o áreas donde consistentemente necesitas mejorar.
Puedes ejecutar la Revisión de documentos varias veces. Realiza cambios basados en los comentarios y vuelve a revisar para comprobar si los problemas se han resuelto. Este enfoque iterativo te ayuda a aprender qué funciona y a refinar tu contenido progresivamente.
## Interpretar los comentarios
Los comentarios de la Revisión de documentos están organizados en categorías claras. Así puedes interpretarlos y actuar sobre ellos:
### Comentarios sobre estructura
**Qué te dice:** Qué tan bien fluye tu contenido, si las secciones están equilibradas y si la arquitectura de la información tiene sentido.
**Ejemplo de comentario:**
* "La introducción es demasiado larga en relación al resto del documento"
* "La sección 3 carece de una transición clara desde la sección 2"
* "La jerarquía de encabezados salta de H2 a H4"
**Cómo usarlo:** Reorganiza secciones, ajusta el ritmo, corrige los niveles de encabezado o añade contenido de transición.
### Comentarios sobre claridad
**Qué te dice:** Si tu redacción es fácil de entender, si las oraciones son demasiado complejas y dónde pueden confundirse los lectores.
**Ejemplo de comentario:**
* "Este párrafo usa mucho la voz pasiva, lo que dificulta su seguimiento"
* "La jerga técnica en la primera sección puede confundir a lectores no especializados"
* "La longitud promedio de las oraciones es de 35 palabras: considera dividirlas en oraciones más cortas"
**Cómo usarlo:** Simplifica las oraciones, reemplaza la jerga por lenguaje claro o añade definiciones para los términos técnicos.
### Comentarios sobre completitud
**Qué te dice:** Lagunas en tu contenido: contexto que falta, preguntas sin respuesta o áreas que necesitan más detalle.
**Ejemplo de comentario:**
* "El documento menciona 'el nuevo proceso' pero nunca lo define"
* "Los pasos 2 y 3 asumen conocimientos previos no explicados en la introducción"
* "No se incluye conclusión ni próximos pasos"
**Cómo usarlo:** Añade el contexto que falta, amplía secciones escasas o incluye resúmenes y conclusiones.
### Comentarios sobre calidad
**Qué te dice:** Coherencia del tono, problemas de formato y oportunidades para pulir tu contenido.
**Ejemplo de comentario:**
* "El tono cambia de formal a informal entre secciones"
* "Los puntos de la lista tienen formato inconsistente (algunos terminan con punto, otros no)"
* "Este concepto se explica dos veces: considera consolidarlo"
**Cómo usarlo:** Estandariza el formato, mantén un tono coherente, elimina redundancias.
## Uso
La Revisión de documentos consume más de tu cuota de IA que una pregunta simple, ya que analiza el documento completo en una sola pasada. Los documentos más largos y complejos consumen más. Usa **Fast** para revisiones más rápidas y ligeras.
El uso real depende de la longitud del documento, la estructura, la complejidad del formato y el modelo que elijas. Consulta tu uso en el menú del Asistente en **Uso y límites**.
Los comentarios exhaustivos suelen ahorrar tiempo y mejorar la calidad de forma más eficiente que múltiples consultas individuales.
## Consejos para mejores revisiones
**1. Prepara tu documento primero**
Asegúrate de que tu documento esté razonablemente completo antes de ejecutar una revisión. El Asistente proporciona mejores comentarios sobre borradores terminados que sobre esquemas preliminares.
**2. Especifica tu audiencia**
En un mensaje de seguimiento, dile al Asistente para quién es el documento:
* "Esto es para un equipo técnico familiarizado con el producto"
* "La audiencia son stakeholders no técnicos"
* "Escrito para nuevos usuarios que nunca han usado Craft"
Este contexto ayuda al Asistente a adaptar los comentarios a tus necesidades específicas.
**3. Pide comentarios priorizados**
Si la revisión identifica muchos problemas, pídele al Asistente que priorice:
* "¿Cuáles son los 3 problemas que debo corregir primero?"
* "¿Cuál es el problema estructural más crítico?"
* "Céntrate solo en los problemas de claridad"
**4. Solicita tipos específicos de comentarios**
Puedes orientar la revisión pidiendo un análisis enfocado:
* "Revisa esto en cuanto a coherencia de tono"
* "Comprueba solo la completitud y el contexto que falta"
* "Céntrate en si la estructura tiene sentido para una audiencia principiante"
**5. Usa el modelo adecuado**
* **On-device:** No recomendado para la Revisión de documentos (contexto limitado)
* **Core:** Revisiones estructurales rápidas en documentos cortos
* **Fast:** Buen equilibrio para la mayoría de revisiones (500-2000 palabras)
* **Max:** Mejor para documentos largos y complejos o cuando necesitas los comentarios más completos
## Ejemplo: Antes de publicar una entrada de blog
Sara escribe una entrada de blog sobre el uso de Colecciones en Craft. Antes de publicarla, quiere asegurarse de que sea clara y completa.
Sara abre su borrador en Craft.
Hace clic en el icono del Asistente y selecciona **Revisión de documentos**.
El Asistente analiza el documento y proporciona comentarios:
* **Estructura:** "La introducción es sólida, pero la sección 2 es el doble de larga que las secciones 3 y 4 juntas. Considera dividirla en dos partes."
* **Claridad:** "Varios términos técnicos (relaciones, propiedades, vistas) se usan antes de definirse. Añade un glosario o defínelos en el primer uso."
* **Completitud:** "La entrada explica *qué* son las Colecciones pero no aborda *cuándo* usarlas en lugar de carpetas o etiquetas."
* **Calidad:** "El tono es consistente. Hay una sección redundante al final que repite la introducción: considera eliminarla."
Sara realiza ajustes basados en los comentarios: divide la sección 2, añade definiciones, incluye una sección "Cuándo usar Colecciones" y elimina la redundancia.
Ejecuta la Revisión de documentos de nuevo. El Asistente confirma que los problemas están resueltos.
Sara publica con confianza, sabiendo que el contenido es claro y completo.
## Limitaciones
La Revisión de documentos proporciona comentarios pero no aplica cambios directamente. Para actuar sobre las sugerencias, cambia al modo **Ejecutar** con un modelo **Fast** o **Max** y pídele al Asistente que implemente los cambios recomendados. Consulta [Editar con Craft Assistant](/es/ai-assistant/editing).
Para documentos muy cortos (menos de 200 palabras), la Revisión de documentos puede no aportar mucho valor; el chat general del Asistente suele ser más apropiado para tareas rápidas.
## Artículos relacionados
Aprende a trabajar con el Asistente e iniciar conversaciones
Selecciona el modelo adecuado para la Revisión de documentos y otras tareas
Aplica las sugerencias de revisión directamente en el modo Ejecutar
Crea instrucciones de revisión reutilizables para comentarios consistentes
Entiende el uso de IA para la Revisión de documentos y otras funciones