Buuk es infraestructura de centro de ayuda con un filtro editorial. El contenido vive en un workspace. Los editores redactan, organizan y revisan. Los clientes solo ven páginas publicadas en el sitio público, en la búsqueda, en Ask AI y en el widget.
1. Un workspace es la unidad de docs
Cada workspace tiene nombre, slug, marca, miembros y colecciones. La URL pública se ve como app.getbuuk.com/help/your-slug. En Growth puedes asociar un hostname propio como docs.yourproduct.com.
Owners y editors pueden publicar. Los viewers pueden leer borradores en el panel sin cambiar páginas en vivo.
2. Las colecciones estructuran el sitio público
Un sitio de docs completo (este) activa cinco colecciones. Puedes activar un subconjunto en Customise → site profile.
| Colección | Inicio del editor | Pestaña pública |
|---|---|---|
| Documentación | Articles | Help |
| FAQ | FAQ | FAQ |
| Guías | Docs → Guides | Guides |
| Referencia de API | Docs → API Reference | API Reference |
| Changelog | Docs → Changelog | Changelog |
Las secciones y carpetas viven bajo una colección. Los artículos hoja son páginas. Las carpetas se pliegan en la barra lateral para que una navegación larga se pueda escanear.
3. Borrador, vista previa y luego publicar
- Crea o importa un artículo. El guardado es automático. El historial de versiones guarda copias anteriores.
- Previsualiza el layout público desde Help center preview. La vista previa no hace público un borrador.
- Publica cuando el texto esté listo. La URL se mantiene estable mientras el slug no cambie.
- Opcional: programa una hora de publicación o exige aprobación editorial antes de enviar.
El trabajo no publicado queda fuera de la búsqueda pública, el widget y Ask AI para lectores. Trata los borradores como internos hasta que publiques.
4. La IA es asistente de escritura, no el publicador
Ask Buuk en el panel puede redactar un artículo, reescribir una sección o llevarte a ajustes. Las actualizaciones sugeridas convierten tickets, hilos de Slack, releases de GitHub, issues de Linear, búsquedas fallidas y feedback “no útil” en una lista de revisión.
Accept aplica o abre un borrador. Edita antes de publicar. Dismiss si la documentación ya es correcta. Buuk nunca publica una sugerencia por su cuenta.
5. El centro de ayuda público es la superficie del cliente
- Búsqueda en artículos publicados
- Respuestas de IA opcionales con citas a esos artículos
- Feedback útil / no útil en cada página
- Reacciones y comentarios del changelog (sin login de Buuk)
- Widget opcional con búsqueda, chat, anuncios y voz
6. Analytics cierra el ciclo
Los informes muestran vistas y búsquedas. Las búsquedas fallidas y las preguntas de Ask AI sin respuesta se convierten en actualizaciones sugeridas. Doc health y Freshness marcan páginas delgadas, viejas o no verificadas para que sepas qué reescribir.
Una semana típica
- Enviar producto — La app cambia. Releases de GitHub, tickets y preguntas de Slack llegan como siempre.
- Revisar sugerencias — Abre Suggestions. Acepta las que deban ser docs. Deja el resto.
- Editar y publicar — Reescribe en el editor. Revisa Preview. Publica. Freshness y la búsqueda atrapan lo que se te pasó.
Estás viendo ese ciclo corriendo en el propio Buuk. Abre cualquier artículo desde Articles en el panel para editar este texto.