Documentación del equipo
Guías, procesos y decisiones del equipo en un solo sitio: se leen y se escriben en la misma pantalla, con borrador, versiones y enlace para compartir.
Actualizado el . 12 min de lectura
Incluido en todos los planes. Ver precios
La documentación guarda lo que el equipo necesita saber y no cabe en una tarea: cómo se hace un trabajo, qué pidió el cliente, qué se decidió y por qué. Cada documento es de un proyecto o de toda la empresa, y se lee y se escribe en la misma pantalla, sin botón «Editar»: quien puede editar escribe directamente sobre lo que lee. Lo que escribes se guarda solo y cada cambio queda en un historial que puedes restaurar.
Esta guía usa los nombres del perfil Proyectos y tareas. En tu pantalla, el proyecto se llama como diga tu perfil de trabajo: cuenta en Agencia, encargo en Consultoría.
Dónde está
En Gestión de proyectos, Documentación, en la barra (si la ventana es estrecha, en Más). También desde la ficha de un proyecto: el apartado Documentación de su Resumen enseña los tres documentos más recientes, con Ver la documentación para abrir la lista ya filtrada y, si no tiene ninguno y puedes crear, Nuevo documento.
Encontrar un documento
La lista ocupa todo el ancho y se agrupa por la fecha del último cambio, como las notas: Hoy, Ayer, Últimos 7 días, Últimos 30 días y, más atrás, por meses. Cada fila dice el título, el proyecto con su logotipo, «Editado hace 2 días» y Borrador solo cuando lo es. La cabecera cuenta lo que hay: «12 documentos · 3 borradores».
- Buscar documentos busca también dentro del texto.
- Qué es filtra por tipo: Guía, Proceso, Requisito, Decisión u Otro. En el perfil Software, además, API y Arquitectura.
- Quién lo ve: Todo el equipo, Unos departamentos o Solo su autor.
- Solo borradores deja lo que falta por terminar.
- Documentos por proyecto, a la izquierda, aparece cuando hay documentos de más de un proyecto, con Todos y Sin proyecto. En el teléfono, el proyecto va en la hoja de filtros.
Un documento privado de otra persona sale en la lista, pero no se abre: «Solo puede abrirlo su autor».
- Abre un documento en blanco, con el proyecto que tengas elegido.
- Documentos por proyecto: aparece cuando hay documentos de más de uno.
- Buscar documentos, Qué es, Quién lo ve y Solo borradores.
- El título, el proyecto, cuándo se editó y Borrador si lo es. La fila entera lo abre.
Escribir un documento nuevo
Pulsa Nuevo documento
En la cabecera de la lista (con teclado, también la tecla N). Se abre el documento en blanco, con el cursor en el título y el proyecto que tenías elegido ya puesto. No hay ningún paso previo para decidir dónde va.
Revisa la frase de arriba
Encima del título, una frase dice dónde va, qué es y quién lo ve: «En Óptica Vista Mar · Es una guía · Lo ve todo el equipo». Pulsa cada parte para cambiarla. Para cambiar el proyecto necesitas el permiso Ver proyectos.
Escribe
Un título de tres letras o más y el texto. Empieza una línea con # para un título o con - para una lista; la barra de formato se queda arriba al desplazarte y, en el teléfono, va sobre el teclado.
Publícalo
Pulsa Publicar cuando esté listo para el equipo. Hasta entonces es un borrador.
Si falta algo para guardar, la pantalla lo dice donde actúas y te lleva al campo: «Ponle un título de 3 letras o más para guardarlo.», «Escribe algo en el documento para guardarlo.» o, si lo ven unos departamentos, «Elige al menos un departamento en «Lo ven».».
Cómo se guarda
Lo que escribes se guarda solo a los 30 segundos de la última tecla, y al momento con ⌘S en el Mac o Ctrl + S en Windows. La pantalla dice en todo momento si está Guardado o tiene Cambios sin guardar. Si sales con cambios pendientes, la pantalla te pregunta y te ofrece guardarlos.
Si otra persona cambia el documento mientras lo tienes abierto, se carga su versión sin decirte nada, salvo que tengas cambios sin guardar: entonces sale el aviso «Alguien ha cambiado este documento», con Cargar su versión, y lo tuyo no se pisa hasta que lo decidas.
Borrador y publicado
Estados de un documento
Borrador
Se está escribiendo. Sale con la marca Borrador en la lista.Se llega desde Borrador cuando: Publicar
Publicado
Listo para el equipo.
Otras transiciones
- Publicado pasa a Borrador: Pasar a borrador, en el menú del documento.
Publicado o en borrador, el documento lo ve quien diga Quién lo ve: el borrador no lo esconde, solo lo marca como sin terminar.
Quién lo ve
- Todo el equipo: cualquiera de la empresa que tenga acceso a la documentación.
- Solo unos departamentos: las personas de los departamentos que elijas.
- Solo yo (o Solo su autor, si no lo escribiste tú): su autor y quien administra la empresa.
Un documento sin proyecto es de toda la empresa, y solo su autor o un Super Administrador pueden cambiarlo, publicarlo o borrarlo.
El menú del documento
En el … de la cabecera del documento. Las filas de la lista llevan en el suyo los más usados: Publicar, Compartir con un enlace…, Copiar enlace, Pasar a borrador y Eliminar.
- Compartir con un enlace… crea un enlace para alguien de fuera: lo explica Compartir un documento.
- Copiar enlace copia la dirección del documento, para un compañero, y Copiar el texto, su contenido.
- Historial de cambios, con las versiones anteriores.
- Pasar a borrador, si está publicado.
- Eliminar, que pide confirmación: borra el documento y sus versiones y no se puede deshacer. Sus adjuntos van a Eliminados recientemente, de donde se recuperan durante 30 días.
Volver a una versión anterior
Cada guardado con el texto cambiado deja una versión. Abre Historial de cambios, elige la versión y pulsa Restaurar. Antes te pregunta: «Se creará una nueva versión con el contenido de esta. La versión actual quedará en el historial.», así que restaurar nunca pierde nada. Si tienes cambios sin guardar, te ofrece Guardar y restaurar o Restaurar sin guardar.
Compartir un documento
Un documento se comparte de dos formas, igual que un archivo del Gestor de archivos. Elige según quién lo vaya a leer:
Dos formas de compartir un documento
Con un compañero
Copiar enlace
Con alguien de fuera
Compartir con un enlace
Para crear un enlace para alguien de fuera:
Abre Compartir con un enlace
En el … del documento o de su fila, pulsa Compartir con un enlace….
Elige cuándo caduca
En Caduca en eliges 1, 7, 30 o 90 días; de entrada, 7. Debajo ves el día exacto: «Dejará de funcionar el 19 de noviembre». Todos los enlaces caducan.
Crea el enlace
Pulsa Crear el enlace. Aparece en Enlace para compartir y, abajo, en la lista de enlaces. Un documento admite 20 enlaces activos: para crear otro, anula alguno.
Entrégalo
Copiar lo deja en el portapapeles; en el teléfono, Compartir abre la hoja de compartir del sistema. Es la única vez que ves la dirección entera: guárdala o envíala ya. Para otro enlace, Crear otro enlace.
Quien abre el enlace ve el documento con el nombre y el logotipo de tu empresa, y descarga sus adjuntos, también los que añadas después, con las mismas reglas que un enlace del Gestor de archivos. Si un adjunto no se puede entregar ahora, la página se lo dice al pulsarlo («Estamos analizando el archivo» o «Este archivo no está disponible ahora mismo»). Mientras el documento sea un borrador, ningún enlace lo abre.
Si el documento lleva archivos traídos del Gestor de archivos, como los que adjunta tu asistente de IA desde allí, el enlace también los publica. Por eso crearlo pide lo mismo que compartir cada uno con un enlace en el Gestor: el permiso Compartir con un enlace del Gestor de archivos y que el Gestor deje compartir ese archivo. Si no, te avisa de qué archivo lo impide y no crea el enlace.
Ver y anular los enlaces
En Compartir con un enlace, debajo de lo que creas, Enlaces de este documento reúne todos los que abren el documento sin cuenta, también los que crearon tus compañeros, con cuántos siguen activos («2 activos»). Cada enlace dice:
- De qué tipo es: Enlace público, con «Termina en x7Kq», los cuatro últimos caracteres de su dirección, para reconocer el que alguien tiene en un correo. Los que se crearon antes de que todos caducaran salen como Enlace público antiguo: ya también caducan, a los 90 días de ese cambio, y la fila dice cuándo. No llevan «Termina en»: se reconocen por quién los creó y cuándo.
- Hasta cuándo vale: «Caduca mañana a las 09:00».
- Cuántas veces se ha abierto, con su tope si lo tiene: «Abierto 3 de 10 veces».
- Quién lo creó y cuándo: «Lo creaste tú hoy a las 10:20» o «Lo creó Marta Ruiz el 10 de noviembre», en la zona horaria de tu empresa.
Estados de un enlace
Activo
Abre el documento mientras esté publicado.Se llega desde Activo cuando: Llega su fecha
Caducado
Se llega desde Activo cuando: Llega a su tope de usos, si lo tiene
Ya no le quedan usos
Se llega desde Activo cuando: Anular
Anulado
Estado final
No vuelve a abrir nada.
Cada enlace activo tiene Anular. Al pulsarlo, la propia fila pregunta ¿Anular este enlace? con lo que va a pasar: Anular el enlace lo anula, y Cancelar lo deja como estaba. Quien lo tenga deja de poder abrir el documento y sus adjuntos al momento, y la fila pasa a Anulado en su sitio. No se puede deshacer: para volver a compartir, crea un enlace nuevo.
Quien abre un enlace anulado ve «Este enlace ya no funciona», y uno caducado, «Este enlace ha caducado», lo mismo que con un archivo del Gestor de archivos.
El bloque solo lo ve quien puede compartir ese documento, y se pone al día solo: si un compañero crea o anula un enlace, o alguien lo abre, lo ves sin cerrar el diálogo. Tu asistente de IA también puede crear, ver y anular enlaces, siempre que lo confirmes, con la conexión de Gestión de proyectos.
Adjuntos
Al pie del documento, Adjuntos con Añadir archivos. En el ordenador también puedes soltar los archivos sobre el documento o pegar una captura; en la aplicación del móvil, hacer una foto, elegirla de la fototeca o escanear un papel. Las capturas que pegas quedan como adjuntos, debajo del texto. Pulsa un adjunto para verlo sin salir del documento, con flechas para pasar al siguiente. Un documento nuevo admite adjuntos en cuanto se guarda por primera vez.
Si el documento tiene enlaces públicos activos, una línea bajo Adjuntos te lo recuerda: «Este documento tiene 2 enlaces públicos activos: lo que adjuntes también se podrá abrir desde ellos». En un borrador añade «en cuanto lo publiques», porque hasta entonces ningún enlace abre nada. No te impide adjuntar: al terminar, el aviso «Adjuntado. También se puede abrir desde los enlaces públicos» trae Quitar, que lo deshace sin preguntar más, y el archivo va a Eliminados recientemente. La línea solo la ve quien puede editar el documento. Si quien adjunta es tu asistente de IA, te pregunta antes, y si el archivo viene de tu Gestor de archivos, además lo apruebas en tu móvil, como un enlace público del Gestor.
Quién puede hacer qué
Permisos de la documentación por rol
| Permiso | Super Administrador | Gerente | Vendedor | Asistente y Visualizador |
|---|---|---|---|---|
| Ver documentación | Todo: Todo lo de la empresa | Departamento: Lo de su departamento y de los que dependen de él | Asignados: Lo que tiene asignado | Departamento: Lo de su departamento y de los que dependen de él |
| Crear documentación | Todo: Todo lo de la empresa | Departamento: Lo de su departamento y de los que dependen de él | No | No |
| Editar documentaciónEscribir, publicar, adjuntar y restaurar versiones. | Todo: Todo lo de la empresa | Departamento: Lo de su departamento y de los que dependen de él | No | No |
| Eliminar documentación | Todo: Todo lo de la empresa | Departamento: Lo de su departamento y de los que dependen de él | No | No |
| Compartir documentación con enlace | Todo: Todo lo de la empresa | Departamento: Lo de su departamento y de los que dependen de él | No | No |
- Ver documentaciónTodo: Todo lo de la empresa
- Crear documentaciónTodo: Todo lo de la empresa
- Editar documentaciónEscribir, publicar, adjuntar y restaurar versiones.Todo: Todo lo de la empresa
- Eliminar documentaciónTodo: Todo lo de la empresa
- Compartir documentación con enlaceTodo: Todo lo de la empresa
- Ver documentaciónDepartamento: Lo de su departamento y de los que dependen de él
- Crear documentaciónDepartamento: Lo de su departamento y de los que dependen de él
- Editar documentaciónEscribir, publicar, adjuntar y restaurar versiones.Departamento: Lo de su departamento y de los que dependen de él
- Eliminar documentaciónDepartamento: Lo de su departamento y de los que dependen de él
- Compartir documentación con enlaceDepartamento: Lo de su departamento y de los que dependen de él
- Ver documentaciónAsignados: Lo que tiene asignado
- Crear documentaciónNo
- Editar documentaciónEscribir, publicar, adjuntar y restaurar versiones.No
- Eliminar documentaciónNo
- Compartir documentación con enlaceNo
- Ver documentaciónDepartamento: Lo de su departamento y de los que dependen de él
- Crear documentaciónNo
- Editar documentaciónEscribir, publicar, adjuntar y restaurar versiones.No
- Eliminar documentaciónNo
- Compartir documentación con enlaceNo
- Todo:
- Todo lo de la empresa
- Departamento:
- Lo de su departamento y de los que dependen de él
- Asignados:
- Lo que tiene asignado
Sin Editar documentación, el documento se lee con la misma hoja, sin poder escribir en ella.
Si algo falla
- No puedo abrir un documento de la lista. Es privado de otra persona («Solo puede abrirlo su autor»).
- No puedo escribir en un documento. Te falta Editar documentación, o no tiene proyecto y no eres su autor ni Super Administrador.
- No veo Compartir con un enlace…. Te falta Compartir documentación con enlace o tu alcance no llega a ese documento.
- Busco el enlace privado. Ya no hace falta: para un compañero, Copiar enlace. Para que alguien deje de ver el documento, cambia Quién lo ve.
- Quien tiene el enlace ve «Este enlace ha caducado». Pasó su fecha: crea uno nuevo y envíaselo.
- No encuentro la dirección de un enlace que creé. Solo se ve al crearlo. Crea otro y, si nadie usa el anterior, anúlalo.
- En la lista hay un enlace Público, sin caducidad. Es de antes de que todos caducaran y aún no tiene fecha: abre el documento hasta que lo anules. Si ya no hace falta, Anular.
- «Este documento ya tiene 20 enlaces activos». Es el máximo. Anula los que ya no hagan falta y crea el nuevo.
- No me deja crear el enlace por un archivo del Gestor de archivos. El documento lleva ese archivo y el enlace lo publicaría: te falta Compartir con un enlace del Gestor, o el Gestor no deja compartir ese archivo con un enlace (por su tipo, por el antivirus o por tu plan). Quita ese adjunto, o pide el enlace a quien pueda compartirlo.
- Quien tiene el enlace no puede descargar un adjunto. Con «Estamos analizando el archivo», el antivirus aún lo está revisando: que lo intente en unos minutos. Con «Este archivo no está disponible ahora mismo», ese archivo no puede salir por un enlace público, igual que no saldría por uno del Gestor.
- No me deja adjuntar. El documento aún no se ha guardado: escribe el título y algo de texto, y espera a que diga Guardado.
- He perdido un cambio. Abre Historial de cambios: cada guardado con el texto cambiado está ahí.
- «No se ha encontrado el documento». Se ha borrado o ya no tienes acceso.