Colaboración

Los usuarios de planes de pago pueden colaborar con sus compañeros de equipo en la revisión y la redacción de la documentación. Los compañeros de equipo pueden tener distintos roles.

Roles de usuario

Cada compañero de equipo puede tener uno de los cuatro roles de usuario que admitimos. Los roles son, en orden de mayor a menor autoridad:

  • Admin, donde el Owner siempre es administrador.

  • Publisher

  • Writer

  • Reviewer

A continuación se detalla un desglose de los permisos:

Rol

Admin

Publisher

Writer

Reviewer

Leer borradores y páginas publicadas

✅

✅

✅

✅

Ver el historial de la página

✅

✅

✅

✅

Comentar en las páginas

✅

✅

✅

✅

Ver compañeros de equipo

✅

✅

✅

✅

Descargar la exportación en PDF

✅

✅

✅

✅

Crear/editar borradores de páginas

✅

✅

✅

❌

Crear/editar borradores de referencias de API

✅

✅

✅

❌

Crear bloques sincronizados

✅

✅

✅

❌

Crear una sección de documentación sin publicar

✅

✅

✅

❌

Eliminar páginas

✅

✅

❌

❌

Crear categorías, etiquetas, enlaces y separadores de la barra lateral

✅

✅

❌

❌

Crear/eliminar/publicar versiones

✅

✅

❌

❌

Publicar/eliminar secciones de documentación

✅

✅

❌

❌

Publicar/eliminar referencias de API

✅

✅

❌

❌

Modificar la configuración de la documentación, las referencias de API y las versiones

✅

✅

❌

❌

Editar/archivar bloques sincronizados

✅

✅

❌

❌

Publicar páginas

✅

✅

❌

❌

Importar/exportar el proyecto

✅

✅

❌

❌

Generar exportación en PDF/enlace permanente

✅

✅

❌

❌

Cambiar las variables del proyecto

✅

✅

❌

❌

Bloquear/desbloquear versiones

✅

✅

❌

❌

Cambiar de plan

✅

✅

❌

❌

Gestionar compañeros de equipo

✅

❌

❌

❌

Cambiar la configuración del proyecto

✅

❌

❌

❌

Crear/ver/revocar clave de API

✅

❌

❌

❌

Eliminar el proyecto

Solo el propietario

❌

❌

❌

Configuración de compañeros de equipo

Si tienes un plan de pago, puedes invitar a tus compañeros a colaborar desde el panel Team:

  • Abre Project Settings → Team. También puedes abrir el menú de usuario en la navegación superior y elegir Invite teammates.

  • Haz clic en Invite editor, introduce la dirección de correo electrónico del compañero al que quieres invitar y haz clic en Invite.

  • Para cambiar el rol de un compañero, abre el menú en su fila y elige el rol en Change role.

  • Para cambiar el nombre visible de un compañero, abre el mismo menú y selecciona Edit name.

Si aún no es usuario, se enviará un mensaje de correo electrónico a su dirección para ayudarle a registrarse. Se añadirá a la lista y aparecerá una insignia "Invited" junto a su dirección de correo hasta que se registre.

Si ya es usuario, se enviará un mensaje de correo electrónico a su dirección para avisarle de que puede colaborar en este proyecto. Se añadirá automáticamente y no tendrá que hacer nada.


Eliminar a un compañero de equipo

Para eliminar a un compañero de equipo, haz lo siguiente:

  • Abre Project Settings → Team.

  • Abre el menú en su fila y selecciona Remove from project.

Esto lo elimina solo del proyecto. Si tu organización añade automáticamente a todos los miembros a todos los proyectos, Remove from project no se muestra; gestiónalos desde Organisation Settings.

Organizaciones

Si tus proyectos forman parte de una organización, el propietario de la organización también puede deshabilitar a un miembro desde Organisation Settings → Team. Deshabilitarlo le impide iniciar sesión en cualquier proyecto, pero conserva su cuenta y su historial, y se puede deshacer. Consulta Configuración de la organización.

Si tu organización está gestionada (para Enterprise), consulta Deprovisioning Users.

Cambiar la propiedad del proyecto

Para transferir la propiedad a otro compañero de equipo:

  1. Asegúrate de que el usuario haya sido invitado y ya se haya unido al proyecto como compañero de equipo.

  2. Abre Project Settings → Team.

  3. Abre el menú en su fila y selecciona Make owner. Solo el propietario actual ve esta opción.

  4. Confirma tu elección. El usuario recibirá un correo electrónico indicando que se ha convertido en propietario del proyecto.

Transferir la propiedad

Una vez que transfieras la propiedad, no podrás recuperarla a menos que el nuevo propietario te la devuelva.

La facturación no está vinculada a la propiedad

Si tienes un plan de pago, la factura se enviará por defecto a la dirección de correo electrónico del usuario que compró el plan, no a la del propietario. Si deseas modificar el correo electrónico utilizado para recibir facturas, consulta Changing Payment/Billing Details.


  Última actualización