Comentarios en documentos

Cuando se integran con un espacio de trabajo conectado, los proyectos de Altium Designer permiten que un equipo de diseño distribuido colabore en proyectos almacenados y gestionados de forma centralizada. La interfaz de diseño permite añadir comentarios en diversos documentos de diseño para mejorar el proceso de colaboración. Los comentarios, es decir, las notas añadidas por los usuarios, pueden colocarse en los documentos y recibir respuestas de otros usuarios.

El panel Comments and Tasks 

Los comentarios colocados están disponibles en tiempo real para los usuarios que colaboran (aquellos que tienen acceso compartido al documento) y se guardan en el servidor de forma independiente del proyecto, sin modificar en modo alguno los documentos que lo componen. La función de comentarios se gestiona mediante el panel Comments and Tasks. Al seleccionar una entrada de comentario en el panel Comments and Tasks, el sistema abre (y carga, si es necesario) el documento de diseño asociado.

El panel Comments and Tasks permite añadir comentarios a un área o punto definidos en el documento activo de un proyecto del espacio de trabajo y asignar estos comentarios a miembros del espacio de trabajo, creando así tareas para ellos. El panel permite a todos los usuarios que trabajan en el documento añadir comentarios y ver todos los comentarios sin modificar el propio documento. Esta función facilita procesos de colaboración sólidos y resulta muy útil cuando es necesario señalar problemas en el documento sin tener que fusionar cambios ni generar conflictos. El panel Comments and Tasks puede utilizarse, en esencia, para crear una lista de tareas pendientes y, a medida que avanza el diseño, los comentarios pueden resolverse y cerrarse. Los comentarios colocados están disponibles en tiempo real para los usuarios que colaboran —aquellos que tienen acceso compartido al documento— y se guardan en el espacio de trabajo de forma independiente del proyecto, sin modificar en modo alguno los documentos que lo componen.

Tenga en cuenta que los comentarios y las tareas pueden añadirse y gestionarse tanto en Altium Designer como en el espacio de trabajo relacionado, mediante la vista de diseño de su interfaz de navegador. La funcionalidad de ambos sistemas de comentarios es esencialmente la misma y, dado que tanto los datos del proyecto como los de los comentarios se almacenan en el espacio de trabajo, los sistemas funcionan conjuntamente en tiempo real.

Consulte Commenting in the Web Viewer (espacio de trabajo de Altium 365, espacio de trabajo de Enterprise Server) para obtener información detallada sobre el sistema de comentarios en la interfaz de navegador de un espacio de trabajo.

Dónde se admiten comentarios

Esquema

Se puede añadir un comentario a un objeto, a un punto específico o a un área de un documento esquemático.

PCB

Se puede añadir un comentario a un objeto, a un punto específico o a un área de un documento de PCB (en el modo de diseño 2D): .

Tenga en cuenta que, al enfocar un comentario en un documento de PCB, se cambiará automáticamente a la misma vista que tenía el revisor (capas visibles, capa activa, vista superior/inferior). A continuación se muestra un ejemplo del cambio de configuración de la vista al enfocar un comentario.

❯ ❮ Javascript ID: PCB_Support1

La configuración de la vista antes de enfocar un comentario: todas las capas de señal están habilitadas, Bottom es la capa activa y la placa se muestra desde el lado inferior. La placa después de enfocar un comentario (se aplica la misma vista que había cuando se añadió el comentario): Top es la única capa de señal habilitada, Top es la capa activa y la placa se muestra desde el lado superior.

Draftsman

Se puede añadir un comentario a un punto específico o a un área de un documento de Draftsman de un proyecto de PCB, de múltiples placas o de diseño de arneses: .

Esquema de múltiples placas

Se puede añadir un comentario a un objeto o a un punto específico de un documento esquemático de múltiples placas: .

Ensamblaje de múltiples placas

Se puede añadir un comentario a un punto específico del documento de ensamblaje de múltiples placas : .

Diagrama de cableado y plano de disposición de arneses

Se puede añadir un comentario a un objeto, a un punto específico o a un área de un documento de diagrama de cableado o plano de disposición de un proyecto de diseño de arneses. 

ActiveBOM

Se puede añadir un comentario a una fila de un documento de ActiveBOM: .

Acceso al panel Comentarios y tareas

Se puede acceder al panel desde un proyecto del espacio de trabajo de las siguientes maneras:

• Haga clic en el botón Panels situado en la esquina inferior derecha del espacio de diseño y, a continuación, seleccione Comments and Tasks.

  El icono de espacio de trabajo situado junto al nombre de un panel en el menú de la esquina inferior derecha del espacio de diseño indica que se requiere una conexión a un espacio de trabajo para ver los datos del panel asociado. Un icono azul () indica que actualmente hay una conexión a un espacio de trabajo. Un icono gris () indica que actualmente no hay conexión a un espacio de trabajo y se le pedirá que se conecte a uno antes de poder acceder a los datos del panel.

• Seleccione el comando View » Panels » Comments and Tasks en los menús principales.

• Haga doble clic en la chincheta de un comentario colocado en el espacio de diseño.

Añadir un comentario sin estar conectado a un espacio de trabajo

Antes de utilizar la función de comentarios, asegúrese de estar conectado a su espacio de trabajo y de haber abierto un proyecto y uno de los tipos de documento que admiten comentarios (incluidos esquemas, PCB 2D, Draftsman y ActiveBOM). Utilice el comando File » Open Project para elegir un proyecto del espacio de trabajo entre los que se han compartido con usted. El panel Comments and Tasks proporcionará indicaciones sobre estos requisitos previos.

Opciones del panel Comentarios y tareas

Utilice los botones de la parte superior del panel Comments and Tasks para configurar la disponibilidad de los comentarios en el panel y en el área del editor, así como para especificar si se notifica a los usuarios mencionados.

El botón  del panel permite mostrar u ocultar los marcadores de comentarios en el documento. Las entradas de comentarios de la lista del panel Comentarios y tareas se pueden seguir seleccionando de la forma habitual.

Utilice el menú desplegable de filtros del panel () para configurar el filtrado de comentarios y el botón  asociado para alternar entre la vista filtrada y la vista sin filtrar.

• TYPE - active el tipo que desee mostrar. Todos están activados de forma predeterminada.

• SCOPE - active Current document para mostrar únicamente los comentarios del documento actual.

• ASSIGNEE - todas las opciones están desactivadas de forma predeterminada. Por lo tanto, se muestran todas las tareas y comentarios, ordenados por nombre (la primera entrada de la lista corresponde al usuario actual). Al activar las casillas de uno o varios usuarios, se mostrarán las entradas de los usuarios seleccionados. 

• Clear Filters - permite restablecer rápidamente los valores predeterminados del filtrado.

Utilice las opciones del menú del botón  para configurar la visibilidad de los comentarios y las notificaciones:

• Unresolved Only – los comentarios resueltos no se incluyen en la lista.

• Notification settings – haga clic para abrir el cuadro de diálogo Notification Settings y configurar la recepción de alertas por correo electrónico para toda la actividad de comentarios de este diseño (All), solo para los comentarios en los que se le mencione o que se le asignen (My), o para no recibir ninguna alerta por correo electrónico (None). ► Ejemplo del contenido de un correo electrónico.

• Export Comments – haga clic para abrir el cuadro de diálogo Comment Export Configuration y configurar la exportación de comentarios a un archivo PDF.

  

El PDF de salida incluirá información sobre los comentarios del diseño: ID del comentario, autor, fecha y hora de creación, texto del comentario, persona asignada (para las tareas) y estado (para un comentario, si está Resolved; para una tarea, su estado To Do / In Progress / Resolved). Puede optar por exportar todos los comentarios asociados al diseño, independientemente de cuándo se hayan realizado, o solo los realizados entre versiones publicadas específicas del diseño. También hay varias opciones para definir qué capturas de pantalla se incluirán en el documento PDF generado. En conjunto, ambas permiten saber dónde se encuentra un comentario y a qué se aplica (punto, componente o área). Si deja ambas opciones sin marcar, solo se incluirán los comentarios. Una vez configuradas las opciones, haga clic en Export para generar el PDF y utilice el cuadro de diálogo que aparece a continuación para determinar dónde guardarlo y con qué nombre (de forma predeterminada, el del proyecto).

• Entire designs snapshots - incluye una captura de cada documento de origen que contenga un comentario dentro del período indicado Period. Esto permite confirmar visualmente dónde se encuentra el comentario en el documento mediante un marcador de comentario numerado.
• Original design screenshots - incluye la captura original tomada al crear un comentario (que también está disponible en la ventana Contextual Commenting al hacer clic en un marcador de comentario en el área de diseño principal). Esta captura muestra el punto, el área o el componente al que se aplica el comentario.

Colocación

Para colocar un comentario en el área de diseño de un editor gráfico basado en objetos, como el de esquemas, PCB 2D o Draftsman, ejecute primero el comando correspondiente. Para ello, realice una de las siguientes acciones:

• Haga clic en el botón  disponible en el panel Comments and Tasks.

• Haga clic en  cerca de la esquina superior derecha del área de diseño.

• Haga clic en Place » Comment en los menús principales.

• Utilice el método abreviado de teclado Ctrl+Alt+C.

• Haga clic con el botón derecho en el área de diseño y seleccione Comment.

Según el tipo de documento (véase más arriba), los comentarios pueden asignarse a un objeto, a un punto específico o a un área del documento activo. El comando activa el modo de colocación de comentarios y el cursor cambia a una cruz con un círculo azul que detecta y resalta los objetos que se pueden seleccionar:

• Haga clic en un objeto resaltado para asociar (anclar) un comentario a ese objeto.

• Haga clic en un área no resaltada para asociar un comentario a ese punto específico del documento.

• Haga clic fuera de un objeto y arrastre el cursor para crear un área rectangular resaltada y asociar un comentario al área especificada ().

En un documento ActiveBOM, haga clic en una celda para añadir un comentario a esa fila de la lista de materiales (BOM). Haga clic con el botón derecho en una fila y seleccione el comando Comment para añadir un comentario a esa fila.

La acción de colocación abre un cuadro de diálogo de introducción de comentarios que ofrece un campo para introducir el texto del comentario y, en los documentos gráficos, una opción adicional para añadir un dibujo a mano alzada al comentario cuando corresponda (). Seleccione la opción Assign a task to para asignarse una tarea a sí mismo o a uno de los usuarios mencionados en el comentario (consulte los detalles a continuación). Haga clic en  para confirmar la creación del comentario; este quedará asociado a un marcador numerado en el documento y se añadirá una entrada con el resumen del comentario al panel Comments and Tasks.

Colocación de un comentario en un objeto, mención de otro usuario registrado en el comentario, desplazamiento del marcador del comentario y adición de un dibujo a mano alzada al comentario.

Menciones y asignaciones de tareas

Además de texto, en el cuadro de diálogo de introducción de comentarios se puede añadir una «mención» a cualquier otro usuario o rol registrado en el espacio de trabajo conectado introduciendo el carácter @. Seleccione un nombre o correo electrónico de la lista desplegable para añadir la referencia al usuario (miembro del espacio de trabajo) al comentario y también como una entrada de Assign a task to; básicamente, se asignará una task al usuario. Desmarque esta última opción si no desea que el comentario se considere asignado específicamente a ese usuario. También se puede añadir como mención un grupo de roles (por ejemplo, «Ingenieros») y, por tanto, los usuarios que lo componen.

Si un usuario mencionado no tiene acceso al proyecto actual, se le invitará a compartirlo con ese usuario. Esta opción está disponible si usted es el propietario del proyecto o un administrador del espacio de trabajo. Los derechos de acceso del usuario se conceden mediante el cuadro de diálogo Compartir; el usuario recibirá un correo electrónico que le notificará el acceso compartido. Si cancela el cuadro de diálogo Compartir, el proyecto no se compartirá, pero el comentario se colocará de la forma habitual.

► Consulte más información sobre cómo compartir un diseño.

Cuando se asigna una tarea a un usuario, la imagen o foto de ese usuario se muestra en la parte superior izquierda del cuadro de diálogo del comentario y de la tarjeta del comentario en el panel Comments and Tasks. Además, la tarea recibirá un nombre compuesto por el nombre del proyecto y el número de secuencia (por ejemplo, Kame_FMU-1), en lugar de un simple número, como ocurre con los comentarios normales. Este nombre también se muestra en el cuadro de diálogo del comentario y en la tarjeta del comentario. Haga clic en él para abrir la página Tasks del proyecto en la interfaz web del espacio de trabajo, con la tarea seleccionada resaltada en la lista de tareas.

Posicionamiento

La ubicación de un comentario en el espacio del editor se cambia arrastrando su «chincheta» asociada a una nueva posición, durante o después de su colocación. Al seleccionarla, la chincheta del comentario incluye una línea de conexión con el objeto o área asociados.

Tenga en cuenta que también puede posicionar un comentario durante su colocación inicial haciendo clic y arrastrando en el modo de colocación ().

Pegar imágenes

Puede añadir una imagen a un comentario copiándola primero desde una ventana de Explorer  o una página del navegador haciendo clic con el botón derecho en la imagen, lo que la copia al portapapeles. Para adjuntar la imagen, haga clic con el botón derecho y seleccione Paste (o utilice el atajo de teclado Ctrl+V ) en el propio comentario (en el campo que indica Add others with @ or paste images). 

Cada imagen puede tener un tamaño máximo de 2 MB. Después de pegarla en el comentario, haga clic en ella para mostrar la imagen completa, como se muestra en la imagen de la derecha.

También puede publicar un comentario que incluya únicamente una imagen pegada, sin texto, como se muestra a continuación.

Dibujo

Al colocar o editar un comentario, seleccione el botón de opción  para añadir un dibujo a mano alzada con el cursor de lápiz que aparece. Haga clic y arrastre para crear líneas y, a continuación, haga clic con el botón derecho para finalizar y asociar el dibujo al comentario seleccionado actualmente.

Para acceder al modo Freehand Drawing del panel Properties, pulse la tecla Tab cuando el modo de dibujo a mano alzada esté activo (lo indica el icono  en el espacio de diseño). Estas opciones permiten deshacer y rehacer comentarios en el menú desplegable Commands y cambiar el grosor, el tamaño y el color en el menú desplegable Properties .

Tareas generales

Las tareas generales (tareas que se aplican al proyecto actual, pero que no están asociadas a un comentario o documento del proyecto) se muestran en el panel en un grupo separado bajo la entrada del proyecto. El panel muestra el mismo contenido y los mismos atributos para las tareas generales (persona asignada, prioridad, etc.).

Las tareas generales se enumeran en el panel Comments and Tasks.

Haga clic en una entrada de tarea general en el panel para acceder a sus cuadros de diálogo de comentarios. Utilice el cuadro de diálogo para publicar comentarios (incluidos aquellos con imágenes pegadas) para la tarea general seleccionada.

Comentarios desvinculados

Cuando se elimina un documento del proyecto o cambia su UniqueID, los comentarios del documento pueden quedar «desvinculados». Estos comentarios siguen estando disponibles en la sección contraíble Detached Comments del panel. Haga clic en la tarjeta de un comentario desvinculado en el panel Comments and Tasks para mostrar su cuadro de diálogo en el espacio de diseño del documento abierto actualmente.

Trabajar con comentarios

Los comentarios insertados en un documento de diseño se registran tanto en el panel Comments and Tasks (como una secuencia de entradas numeradas) como en el editor de documentos correspondiente (como marcadores numerados). Cada entrada del panel representa un hilo de comentarios y proporciona información resumida, como quién insertó el comentario y cuándo, el texto del comentario inicial, las menciones o asignaciones aplicadas y el número de respuestas del hilo.

Para abrir un hilo de comentarios, seleccione su entrada en el panel Comments and Tasks o haga clic en su marcador asociado en el espacio de diseño. Esto resalta el comentario en el editor de documentos y abre el cuadro de diálogo del comentario, que incluye el comentario inicial y las respuestas de los usuarios. Si el comentario seleccionado está asociado a otro documento de diseño, el sistema abrirá ese documento (y lo cargará, si es necesario).

Navegación por los comentarios mediante la selección de marcadores en el espacio de diseño y de entradas en el panel Comments and Tasks.

Cuadro de diálogo de comentarios

La interacción con un comentario insertado se realiza a través del cuadro de diálogo emergente de comentarios, que muestra todas las entradas del hilo seleccionado e incluye opciones para obtener una vista previa, responder, editar, resolver y eliminar una entrada. El cuadro de diálogo se abre al insertar un comentario o al seleccionar un comentario existente en el panel Comments and Tasks o en el espacio de diseño. Pulse Esc o haga clic en el espacio de diseño para cerrar el cuadro de diálogo de comentarios.

Recorra secuencialmente todos los comentarios disponibles mediante los botones anterior/siguiente () de la cabecera del cuadro de diálogo.

Vista previa

Seleccione la opción Original Snapshot del comentario inicial para ver una captura del área del editor en el momento en que se insertó el comentario. Haga clic en el icono de la esquina superior derecha de la captura o en la propia captura para abrir una vista previa a tamaño completo (haga clic en el icono  de la esquina superior derecha de esta vista previa o en la propia imagen para cerrarla).

Responder

Introduzca texto y, opcionalmente, una mención a un usuario ('@') en el campo Reply para añadir una nueva entrada al hilo de comentarios. Seleccione la opción Assign a task to para crear una tarea asignada al usuario especificado en el menú desplegable. Haga clic en  para confirmar la entrada.

Editar y eliminar

El autor de un comentario existente puede editarlo mediante la opción Edit, disponible en el menú  del comentario. Haga clic en el botón  para confirmar la edición del comentario.

Utilice la opción Delete para eliminar el comentario seleccionado actualmente. Tenga en cuenta que se eliminará todo el hilo si se elimina el comentario inicial (en lugar de una respuesta).

Utilice la opción Convert to Task para convertir el comentario en una tarea asignada a usted mismo.

Utilice la opción Copy Link para copiar la URL del hilo de comentarios. Este enlace permite abrir el proyecto en el Web Viewer de la interfaz web del espacio de trabajo, con el objeto, punto o área del comentario ampliado y centrado.

Resolver

Haga clic en el botón / para alternar el estado del comentario entre Resolved y Unresolved (el valor predeterminado). Un comentario resuelto (cerrado como completado) está inactivo y no se puede editar; tanto su entrada en el panel Comments and Tasks como su marcador en el documento aparecen atenuados.

Establecer prioridades y estados de las tareas

Si se ha asignado un comentario de tarea a un usuario, se pueden establecer su prioridad y su estado. Inicialmente, a una tarea se le asignan automáticamente la prioridad Medium y el estado To Do, pero ambos pueden cambiarse haciendo clic en el control correspondiente de la parte superior del cuadro de diálogo del comentario.

Etiqueta de confirmación, ID de revisión de la publicación e información de la revisión de diseño 

Las etiquetas de confirmación y los ID de revisión de la publicación se muestran al visualizar los comentarios o tareas correspondientes tanto en el panel Comments and Tasks como en el cuadro de diálogo de comentarios de Altium Designer.

• Los comentarios creados en el visor web al visualizar la instantánea del diseño de una confirmación etiquetada incluirán el nombre de la etiqueta asociada. Haga clic en el enlace del nombre de la etiqueta para abrir la instantánea de la confirmación correspondiente en el visor web.

• Los comentarios creados en el visor web al visualizar una publicación específica incluirán el ID de revisión de la publicación. Haga clic en el enlace del ID de revisión de la publicación para abrir el portal de fabricación correspondiente.

• Los comentarios creados en el visor web al visualizar una instantánea de una revisión de diseño incluirán la entrada de dicha revisión. Haga clic en el enlace de la revisión de diseño para abrir su página.

Trabajar con tareas de Jira

Si la integración con Jira está habilitada y configurada para su espacio de trabajo de Altium 365, los comentarios insertados incluirán la opción adicional de crear una incidencia en su servicio Atlassian Jira® y vincularla al comentario. Al igual que los comentarios convencionales y sus tareas asociadas, las incidencias de Jira insertadas pueden visualizarse, editarse y comentarse desde los documentos de diseño, así como visualizarse y seleccionarse a través del panel Comments and Tasks.

Una instancia de tarea de Jira insertada se sincroniza con su incidencia correspondiente en el espacio de Jira. La sincronización bidireccional de datos entre las incidencias de Jira y las tareas del espacio de trabajo permite gestionar los proyectos de diseño desde el espacio de Jira junto con Altium 365.

Crear una incidencia de Jira

Para insertar una tarea de incidencia de Jira en un proyecto de diseño, inserte primero un comentario de la forma habitual y, a continuación, seleccione la opción Jira Issue en el cuadro de diálogo del comentario. Después, elija un tipo de incidencia y añada un resumen para crear la tarea de incidencia de Jira sincronizada.

Seleccione el Task ID de la incidencia de Jira del espacio de trabajo en el cuadro de diálogo de comentarios o en el panel Comments and Tasks para abrir directamente esa incidencia en el espacio de Jira en una nueva pestaña de su navegador predeterminado. El Task ID del espacio de trabajo se corresponde con el Issue Key del espacio de Jira, y los principales parámetros de Jira, como Resumen, Descripción, Persona asignada y Comentarios, se vinculan entre ambas instancias. El usuario del espacio de trabajo que creó la incidencia de Jira es el informador de la incidencia en Jira. Tenga en cuenta que se incluye una captura del documento actual del espacio de trabajo como archivo adjunto de Jira si se seleccionó la opción Attach original snapshot al crear la incidencia de Jira del espacio de trabajo (véase más arriba).

Una tarea de Jira colocada en el espacio de trabajo creará una incidencia de Jira sincronizada en el espacio de Jira. Ambas se vinculan mediante la correspondencia entre el Task ID del espacio de trabajo y el Issue Key de Jira.

Además de los parámetros vinculados entre las incidencias del espacio de trabajo y de Jira, también se sincronizan los ajustes de estado Priority y Progress relacionados con la tarea. Por ejemplo, cambiar la prioridad de la tarea de la incidencia del espacio de trabajo de Medium a High se reflejará inmediatamente en la incidencia de Jira, y cambiar el estado de progreso de To Do a In Progress en Jira cambiará de forma similar el estado de la incidencia de Jira del espacio de trabajo. Es posible que sea necesario actualizar los datos (haciendo clic en el botón  situado en la parte superior del panel Comments and Tasks) para ver los datos actualizados.

Vincular a una incidencia de Jira

La integración de Jira con Altium 365 también permite vincular una tarea del espacio de trabajo a una incidencia de Jira existente en su servicio Atlassian Jira mediante el modo Jira Issue del cuadro de diálogo de comentarios. Puede vincularla a cualquier incidencia del proyecto de Jira especificado, que se sincronizará con la tarea de Jira del espacio de trabajo.

❯ ❮ Javascript ID: LinkJiraIssue

Coloque una instancia de comentario en el área del documento o en el objeto que desee asociar con una incidencia de Jira existente y, a continuación, seleccione el modo Jira Issue y la opción Link Issue en el cuadro de diálogo de comentarios. Utilice la lista desplegable Select or search issues para seleccionar la incidencia de Jira (que se muestra como un texto Summary) que se vinculará a la instancia de tarea de Jira recién colocada. Empiece a escribir en el campo de texto para buscar la incidencia de Jira que necesite. La lista desplegable Jira Issue del cuadro de diálogo mostrará la incidencia seleccionada del espacio de Jira. Si es necesario, marque la opción Attach original snapshot para transferir a Jira una imagen de la vista actual del documento. Haga clic en el botón Post para establecer el vínculo entre la tarea de Jira del espacio de trabajo y la incidencia de Jira seleccionada. La nueva tarea de la incidencia de Jira se muestra en el panel Comments and Tasks y en el cuadro de diálogo de comentarios, que incluirá los comentarios existentes (o añadidos); seleccione la opción Show all Replies del cuadro de diálogo para ver la lista completa.

La incidencia de Jira vinculada está ahora sincronizada con la tarea de Jira del espacio de trabajo, que incluye el Comments de la incidencia y está configurada con los estados Progress y Priority definidos por la incidencia de Jira: In Progress y High en este ejemplo. Tenga en cuenta que las entradas Web links de la incidencia de Jira indicarán ahora que se ha vinculado (o vuelto a vincular) una tarea de Jira de un espacio de trabajo de Altium 365 a esta incidencia.

Una incidencia de Jira existente se vincula a una tarea del espacio de trabajo especificando su entrada Jira Issue en el modo Link Issue del cuadro de diálogo de comentarios del espacio de trabajo.

Panel de tareas pendientes

Aunque el espacio de trabajo al que está conectado ofrece un completo conjunto de funciones para comentar y asignar tareas, descritas anteriormente, también puede acceder al panel To-Do para realizar un seguimiento de sus tareas. El panel To-Do enumera todos los elementos de tareas pendientes definidos actualmente para el proyecto activo. Un elemento de tarea pendiente se utiliza como recordatorio de una tarea que debe realizarse más adelante en relación con un documento.

El panel To-Do