Entender los sitios de documentación
Los sitios de documentación convierten tus artículos de Clevera en un centro de ayuda alojado con búsqueda, un asistente de IA, comentarios de los lectores e idiomas. Aquí verás qué obtienen los lectores, quién puede hacer qué y qué cuesta créditos.
Un sitio de documentación es un centro de ayuda alojado creado a partir de los artículos de tu espacio de trabajo de Clevera. Escribes y editas artículos donde ya residen, los añades a un sitio como páginas y los publicas. Los lectores obtienen un sitio público rápido con búsqueda, un asistente de IA que cita tus páginas y una forma de decirte qué no les resultó útil. Los sitios de documentación están incluidos en todos los planes, incluido el gratuito.
Cómo funciona un sitio de documentación
- Tus artículos son las páginas. Una página en un sitio de documentación muestra un artículo de tu biblioteca. Edita el artículo y la página cambiará en la siguiente publicación. El artículo permanece en Contenido; eliminar la página del sitio nunca lo borra.
- Publicas versiones. Los cambios se acumulan hasta que se publican como una nueva versión. Cada versión se guarda en Publicando, para que puedas ver qué cambió y revertir los cambios.
- Tiene su propia dirección. Cada sitio obtiene una dirección gratuita,
your-site.clevera.help. En el plan Starter y superiores, puedes servirlo desde tu propio dominio, comohelp.example.com. - Los lectores nunca ven tu espacio de trabajo. Solo ven el sitio. Las personas en tu espacio de trabajo lo gestionan desde Sitios de documentación en la barra lateral.
Cada sitio tiene estas pantallas, agrupadas en su barra lateral:
| Grupo | Pantallas | Qué haces allí |
|---|---|---|
| Visión general | Visión general | Lista de verificación de configuración, tráfico y qué hacer a continuación |
| Contenido | Páginas, Registro de cambios, Redirecciones | Secciones, páginas y su orden; notas de la versión; direcciones antiguas |
| Insights | Analítica, Buscar, Asistente, Comentarios | Visitas, qué buscaron y preguntaron los lectores, valoraciones de página |
| Sitio | Apariencia, Navegación, Dominio, Ajustes, Publicando | Aspecto, menús, tu propio dominio, acceso y el asistente, versiones |
Qué obtienen los lectores
| Función | Qué ven los lectores |
|---|---|
| Página de inicio | Un título, un cuadro de búsqueda, tus secciones como tarjetas de temas y las páginas que destacas |
| Buscar | Buscar… en el encabezado, o ⌘ K / Ctrl K desde cualquier página. Los resultados se actualizan a medida que escriben y recuerdan búsquedas recientes. |
| Asistente de IA | Preguntar a la IA responde preguntas de tus páginas publicadas y enumera las fuentes que utilizó. Lo activas en Ajustes → Asistente de IA. |
| Comentarios de página | "¿Fue útil esta página?" al final de cada página, con razones opcionales y un comentario |
| Idiomas | Un selector de idioma en el encabezado cuando el sitio tiene más de un idioma. Una página sin traducción muestra el idioma predeterminado con un breve aviso. |
| Claro y oscuro | Un interruptor de tema en el encabezado. Tú estableces el predeterminado. |
| Acciones de página | Copiar una página como Markdown, verla como texto sin formato o abrirla en una aplicación de chat de IA para preguntar sobre ella |
| Copias legibles por máquina | llms.txt y copias en Markdown de páginas públicas para herramientas de IA, además de un mapa del sitio para motores de búsqueda |
| Registro de cambios | Una página de notas de la versión con categorías (Nuevo, Mejorado, Corregido, Seguridad, Obsoleto) y un feed RSS |
| Formulario de contacto | Contactar con soporte envía un mensaje a una dirección de correo electrónico que confirmes (Starter y superior) |
Los sitios en el plan Gratuito muestran una pequeña insignia "Powered by". Los planes Starter y superiores pueden eliminarla.
Quién puede hacer qué
Los sitios de documentación utilizan los roles de tu espacio de trabajo. Todos en el espacio de trabajo pueden abrir todos los sitios de documentación.
| Tarea | Propietario | Administrador | Editor | Creador de contenido |
|---|---|---|---|---|
| Abrir sitios, páginas y estadísticas | Sí | Sí | Sí | Sí |
| Editar páginas, secciones y entradas del registro de cambios | Sí | Sí | Sí | Sí |
| Añadir nuevos artículos, páginas de sitio y entradas del registro de cambios | Sí | Sí | No | Sí |
| Publicar, revertir, cambiar aspecto, navegación, dominio y ajustes | Sí | Sí | Sí | No |
| Crear un sitio de documentación | Sí | Sí | No | No |
| Eliminar un sitio de documentación | Sí | Sí | No | No |
| Importar y exportar contenido | Sí | Solo ver | No | No |
Los editores mejoran lo que existe y lo publican; no crean contenido nuevo. Los creadores de contenido escriben y editan, y un propietario, administrador o editor publica. Cuando un control está desactivado para tu rol, su información sobre herramientas indica por qué, por ejemplo: "Solo los propietarios y administradores del espacio de trabajo pueden crear sitios de documentación".
Qué cuesta créditos
Alojar un sitio de documentación es gratuito. La mayor parte de lo que sucede en él no utiliza créditos.
| Acción | Créditos |
|---|---|
| Alojamiento, visitas a la página, visitantes y ancho de banda | Ninguno |
| Búsqueda del lector | Ninguno |
| Respuestas del asistente a los lectores | Ninguno. Cada plan incluye un número mensual de respuestas. |
| Traducir títulos de página, nombres de sección, etiquetas de menú | Ninguno |
| Publicar, revertir, redirecciones, analítica | Ninguno |
| Importar desde otra plataforma, exportar un sitio | Ninguno |
| Generar o traducir una página de sitio con IA | Créditos de IA de artículos. El cuadro de diálogo muestra "Hasta N créditos" antes de empezar. |
| Traducir entradas del registro de cambios | Créditos de IA de artículos |
| Escribir un artículo con IA (en Redactar o el editor de artículos) | Los créditos de artículos habituales |
Consulta Entender los créditos para saber cómo funcionan los créditos y Planes y límites de sitios de documentación para ver qué incluye cada plan.