Documentación colaborativa que todo tu equipo puede mantener de verdad
Los redactores editan de forma visual, los ingenieros trabajan en git y GitHub Sync bidireccional mantiene a todos apuntando a una sola fuente de verdad.
Dos tipos de colaboradores, una sola fuente de verdad
La mayoría de la documentación vive o muere por una tensión sencilla. Las personas que mejor conocen el producto no siempre son las que se sienten cómodas en un editor de código. Tus redactores, gerentes de producto y agentes de soporte quieren abrir una página y empezar a escribir. Tus ingenieros quieren mantener la documentación junto al código, en Markdown, bajo control de versiones, revisada como cualquier otro cambio. Si obligas a todos a un solo flujo de trabajo, la mitad del equipo deja de contribuir.
OpenDocs está creado para la colaboración en documentación entre ambos grupos a la vez. Los colaboradores no técnicos trabajan en un editor visual de bloques sin necesidad de saber Markdown ni git — ven páginas con formato, mueven bloques y guardan. Los ingenieros conectan un repositorio de GitHub y siguen trabajando exactamente como ya lo hacen: editan Markdown, hacen commit a una rama, abren un pull request. La diferencia es que no son dos copias separadas de la verdad que se separan poco a poco. Son el mismo contenido, mantenido en sincronía de forma automática.
Eso es lo que hace sostenible la documentación en equipo. Un líder de soporte puede corregir el pie de una captura equivocada por la mañana, un ingeniero puede actualizar un ejemplo de API esa misma tarde desde su editor, y ninguno tiene que abrir un ticket para el otro ni pegar cambios entre herramientas. La documentación se mantiene al día porque quien está más cerca de cada cambio puede hacerlo directamente, en la superficie que se ajuste a su forma de trabajar.
Cómo funciona la colaboración en OpenDocs
Redactores y PMs en el editor de bloques
El editor visual es donde viven los compañeros no técnicos. Bloques estructurados, encabezados, avisos e imágenes — sin sintaxis que aprender. El Asistente de escritura IA ayuda a redactar, y el AI Writer Improver afina el tono para que muchas manos sigan leyéndose con una sola voz.
Ingenieros en Markdown y git
Conecta un repositorio de GitHub y los ingenieros se quedan en su flujo habitual. Las páginas se guardan como Markdown con frontmatter YAML, así que la documentación vive junto al código, se revisa en pull requests y viaja con cada release — docs-as-code real, sin herramientas nuevas que adoptar.
GitHub Sync mantiene la transparencia
La sincronización bidireccional une el editor y el repositorio. Los guardados del editor generan commits de Markdown a GitHub; los pushes al repositorio actualizan tus páginas. Cuando ambos lados cambian la misma página, la detección de conflictos lo marca con una comparación lado a lado para que nada se sobrescriba en silencio.
Espacios y miembros: estructura sin la fricción del cobro por asiento
La colaboración necesita límites, y en OpenDocs esos límites son los espacios. Un espacio es un conjunto autónomo de documentación — un producto, un centro de ayuda, un manual interno — con su propia navegación, tema y reglas de acceso. Dividir tu documentación en espacios permite que distintos grupos sean dueños de distintas áreas sin tropezarse entre sí, y mantiene el contenido publicado claramente separado del trabajo que aún no está listo.
Sumar personas a ese trabajo nunca debería ser la parte cara, por eso OpenDocs usa niveles planos con miembros incluidos en lugar de cobrar por cada asiento. Pro cuesta $55/mes e incluye 5 miembros. Enterprise cuesta $99/mes e incluye 10 miembros. Cuando tu equipo supera la cantidad incluida, los miembros adicionales son un cargo plano moderado — $5/miembro/mes en la facturación mensual de Pro (o $4/miembro/mes con facturación anual) — así que puedes crecer a una cantidad prácticamente ilimitada de colaboradores sin una factura que dé un salto cada vez que alguien se une.
El contraste con las herramientas de documentación por asiento importa sobre todo para los colaboradores que editan de vez en cuando. En un modelo por asiento, el agente de soporte que corrige una página al mes y el revisor que aprueba un release cuestan cada uno un asiento recurrente completo, así que los equipos terminan racionando el acceso para ahorrar — que es justo como la documentación queda obsoleta. Con miembros incluidos en un nivel plano, sumar un colaborador ocasional es barato o gratis, y los lectores de tu documentación publicada nunca se cobran.
El flujo de GitHub Sync, en detalle
GitHub Sync es el mecanismo que permite que un editor visual y un repositorio de git se mantengan de acuerdo. Conectas un espacio a un repositorio con un Personal Access Token de GitHub, y a partir de ahí los cambios fluyen en ambos sentidos de forma automática. Está disponible en todos los planes, incluida la prueba gratuita — no hay bloqueo por nivel para mantener a tu equipo en sincronía.
- De GitHub a OpenDocs. Cuando alguien hace push de un commit, se dispara un webhook. OpenDocs obtiene los archivos
.mdmodificados y actualiza las páginas correspondientes, así que un ingeniero que edita Markdown en sus propias herramientas ve actualizarse la documentación publicada sin tocar la app. - De OpenDocs a GitHub. Cuando un redactor guarda una página en el editor de bloques, OpenDocs genera un commit de Markdown de vuelta al repositorio a través de la GitHub Contents API, con frontmatter YAML que lleva el título, slug, orden y elemento padre para que la estructura sobreviva el viaje de ida y vuelta.
- Detección de conflictos. Si la misma página cambió en ambos lados, OpenDocs no adivina. Marca el conflicto y muestra una comparación lado a lado, y tú decides qué versión gana — la salvaguarda que hace confiable la edición bidireccional en un equipo real.
El resultado es una historia genuina de docs-as-code que no excluye a nadie. Los ingenieros obtienen control de versiones, revisión por pull request y documentación que se despacha con el código. Los redactores obtienen una página que pueden editar sin aprender git. Y como ambos editan el mismo contenido sincronizado, solo existe una fuente de verdad que mantener al día.
Una voz consistente entre muchos autores
El costo oculto de la documentación en equipo es la deriva del tono. Diez colaboradores escriben, naturalmente, en diez registros, y un sitio de documentación que se lee como un comité debilita la confianza en el contenido. El AI Writer Improver está hecho justo para esto — ejecútalo sobre una página y afina la redacción y suaviza el tono para que las contribuciones de todo el equipo aterricen en una voz consistente, sin que un solo editor se convierta en el cuello de botella de cada cambio. Como todas las funciones de IA, es BYOK: usas tu propia clave de API de Anthropic y el consumo se factura a través de tu cuenta de Anthropic, en todos los planes.
Espacios restringidos para borradores y trabajo interno
No toda colaboración es para el público. Un espacio puede ser público, para lectores que no necesitan cuenta, o restringido para documentación privada en la que tu equipo todavía trabaja. Los espacios restringidos son donde se juntan los borradores, los runbooks internos y la documentación previa al lanzamiento — el equipo colabora internamente y luego publica en un espacio público cuando está listo. Mantener ambos separados evita que el trabajo en progreso se filtre a los lectores, y que la documentación publicada se llene de páginas a medio terminar.
Qué significa colaboración aquí (y qué no)
Vale la pena ser preciso, porque "colaborativo" se estira para significar muchas cosas. OpenDocs no ofrece cursores en vivo ni edición simultánea al estilo de Google Docs sobre una misma página. Dos compañeros no se ven escribir en tiempo real. Si esa experiencia específica es la que necesitas, OpenDocs no es la herramienta adecuada y preferimos decirlo con claridad.
Lo que OpenDocs sí le da a un equipo es una forma duradera de construir documentación en conjunto: roles claros y gestión de miembros, un flujo de git mediante GitHub Sync que deja contribuir a personas técnicas y no técnicas a su manera, detección de conflictos cuando las ediciones chocan, y un ciclo de retroalimentación de lectores que convierte a tu audiencia en otro par de ojos sobre la precisión. Eso es colaboración medida en un sitio de documentación que se mantiene correcto a medida que crece — no en cursores parpadeando.
Los niveles planos le ganan al cobro por asiento cuando tu equipo crece
La colaboración en documentación se vuelve más valiosa con más colaboradores, así que un modelo de precios que te castiga por sumarlos trabaja en contra de todo el propósito. Muchas herramientas de documentación y de espacio de trabajo cobran por asiento, y la factura crece de forma lineal con el número de personas — cada redactor, editor y revisor ocasional es otra línea recurrente. OpenDocs usa niveles planos con miembros incluidos, por lo que un equipo en crecimiento no significa automáticamente una factura mayor.
Pro cuesta $55/mes (o $45.65/mes con facturación anual, $547.80/año) con 5 miembros incluidos. Enterprise cuesta $99/mes (o $82.50/mes con facturación anual, $990/año) con 10 miembros incluidos. Más allá de la cantidad incluida, los miembros adicionales son un cargo plano, y puedes crecer a una cantidad ilimitada de colaboradores. Enterprise agrega analítica, exportación a PDF y Markdown, acceso a la API, SSO/SAML, registros de auditoría y soporte prioritario para las organizaciones que lo necesitan.
El costo de colaborar de un vistazo
| Factor de costo | OpenDocs | Herramientas típicas por asiento |
|---|---|---|
| Modelo de precio | Nivel plano, miembros incluidos | Por asiento |
| Nivel de equipo | $55/mes — 5 miembros incluidos | Crece con cada editor que se agrega |
| Agregar un colaborador ocasional | +$5/miembro/mes (+$4 anual) | Un asiento recurrente completo |
| Lectores de la documentación publicada | Sin cargo (público o restringido) | Varía; a menudo con restricciones |
| Sincronización bidireccional con GitHub | Incluida en todos los planes | A menudo solo en niveles superiores |
Preguntas frecuentes
¿Qué es la documentación colaborativa?
La documentación colaborativa es documentación que mantiene todo un equipo en conjunto, en lugar de un solo dueño. En OpenDocs eso significa que los redactores, gerentes de producto y agentes de soporte editan en un editor visual de bloques mientras los ingenieros trabajan en Markdown y git, y GitHub Sync bidireccional mantiene ambos lados apuntando a una sola fuente de verdad. Los roles, la revisión y un ciclo de retroalimentación compartido reemplazan los traspasos de copiar y pegar que hacen que la documentación quede desactualizada.
¿Pueden trabajar en la misma documentación los redactores no técnicos y los ingenieros?
Sí, esa es la idea. Los colaboradores no técnicos usan el editor visual de bloques sin necesidad de saber Markdown ni git. Los ingenieros conectan un repositorio de GitHub y trabajan en Markdown con frontmatter YAML desde su flujo habitual de ramas y commits. Cada guardado de página se sincroniza en ambos sentidos, así que ambos públicos editan el mismo contenido sin pisarse.
¿OpenDocs admite edición colaborativa en tiempo real como Google Docs?
No. OpenDocs no ofrece cursores en vivo ni edición simultánea de varias personas sobre una misma página. Aquí la colaboración se basa en roles y gestión de miembros, en el flujo de git mediante GitHub Sync y en un ciclo de retroalimentación de lectores, con detección de conflictos cuando dos personas cambian la misma página. Si necesitas coautoría en vivo al estilo de Google Docs, OpenDocs no es esa herramienta.
¿Cómo maneja GitHub Sync los conflictos cuando dos personas editan la misma página?
Cuando la misma página cambia tanto en el editor de OpenDocs como en el repositorio de GitHub, OpenDocs marca un conflicto en lugar de sobrescribir en silencio. Muestra una comparación lado a lado de las dos versiones para que veas exactamente qué difiere y elijas cuál conservar. Nada se pierde de forma automática, lo que mantiene la transparencia entre redactores e ingenieros sobre quién cambió qué.
¿Cuántos miembros de equipo se incluyen y cuánto cuesta agregar más?
Pro cuesta $55/mes de forma plana e incluye 5 miembros; Enterprise cuesta $99/mes e incluye 10 miembros. Los miembros adicionales son un cargo plano ($5/miembro/mes en la facturación mensual de Pro, menos con facturación anual), así que puedes crecer a una cantidad ilimitada de colaboradores sin un precio por asiento que sube cada vez que alguien se une. Los lectores de tu documentación publicada nunca se cobran como asientos.
¿Puedo mantener privados los borradores y la documentación interna mientras el equipo trabaja en ellos?
Sí. Un espacio puede ser público o restringido. Los espacios restringidos son ideales para borradores, runbooks internos y trabajo en progreso que tu equipo colabora antes de publicar, mientras que los espacios públicos atienden a lectores que no necesitan cuenta. Controlas el acceso a nivel de espacio, así que la colaboración y la publicación quedan claramente separadas.