docs

La barra lateral

Secciones organizadas por lo que las cosas significan y no por su origen: lo que tienes abierto, los lugares que conservas, los lugares que navegas, los pull requests e issues que te involucran y por dónde has pasado.

Archivos abiertos

El conjunto de trabajo: cada documento que has abierto explícitamente — desde el Finder, arrastrar y soltar, ⌘O, la línea de comandos o al conservar un archivo de una Ubicación. Plano, reordenable arrastrando, cada fila eliminable con la ✕ que aparece al pasar el cursor (o ⌫ en la fila seleccionada). Clic derecho en la cabecera de la sección para Cerrar todo.

Vistas previas

Un solo clic en un archivo dentro de una Ubicación y se renderiza al instante — y aparece en Archivos abiertos como vista previa: una única entrada en cursiva, siempre la última de la sección. Haz clic en otro archivo y la entrada de vista previa se reemplaza, así que navegar un árbol grande nunca acumula filas. Es la misma idea que las pestañas de vista previa de VS Code o el editor temporal de Xcode, con la misma cursiva.

Una vista previa se convierte en una entrada normal, fijada, cuando le muestras un compromiso más allá de leerla:

• Doble clic en el archivo del árbol, o en la propia entrada en cursiva
• Empezar a editar — entrar en el modo de edición o guardar la edición de un bloque la fija
• Mantener abierto en el menú contextual

Las interacciones de lectura — blame, historial de líneas, inspeccionar una imagen o un diagrama — deliberadamente nunca ascienden una vista previa. Si prefieres que cada clic abra los archivos del todo, cambia Al hacer clic en archivos de Ubicaciones en Ajustes.

Los repos remotos se previsualizan igual, en el mismo lugar. Navegar el árbol de un repo de GitHub, o seguir enlaces dentro de un documento remoto, pone la misma entrada única en cursiva en Archivos abiertos — con un icono de libro y una segunda línea owner/repo @ ref, ya que el archivo no está en tu Mac. Solo existe una vista previa por ventana, local o remota: previsualizar algo reemplaza lo que estuvieras previsualizando antes. Conservar un doc remoto (doble clic o Mantener abierto) es lo que lo archiva con su repo — pasa a la lista de fijados del repo bajo Ubicaciones. ⌘K abre fijando directamente, porque pegar una URL es intención explícita.

Cualquier fila de Archivos abiertos que viva dentro de una Ubicación abierta tiene Mostrar en su ubicación en su menú contextual — el salto de vuelta de «lo que estoy leyendo» a «donde vive».

Fijados

Las carpetas y archivos a los que vuelves una y otra vez, encima de Ubicaciones tal como el Finder mantiene los Favoritos por encima de todo lo demás. Clic derecho en una carpeta o archivo de cualquier árbol y elige Fijar…: una carpeta se convierte en su propia raíz con su propio árbol, un archivo se convierte en una fila de marcador que muestra una vista previa al hacer clic, y la nueva entrada aparece al final de la sección ya en modo de renombrar. Una raíz de Ubicaciones recibe Fijar (se mueve aquí) y una raíz fijada recibe Desfijar (se mueve al final de Ubicaciones, conservando su nombre).

Renombrar funciona a la manera del Finder: elige Renombrar… o pulsa Return en la fila seleccionada, escribe y Return, hacer clic en cualquier otro sitio o pasar a otra cosa confirma el cambio; Escape cancela; un campo vaciado vuelve al nombre real. Una entrada renombrada muestra su ruta real en texto pequeño bajo el nombre, y también lo hace cualquier par de raíces que compartan nombre, así que dos carpetas llamadas docs nunca se ven iguales. Las entradas fijadas son una preferencia, no parte de la sesión: vuelven en cada inicio sin importar lo que diga Reabrir la sesión anterior.

Ubicaciones

Raíces navegables, vivan donde vivan. Dos clases comparten la sección, distinguidas por el icono:

Una carpeta local que es un checkout de git gana un chip de rama (glifo de rama + nombre); si su remoto está en GitHub, aparece además una pequeña marca de libro cerrado — pasa el cursor para ver de qué repo. Hacer clic en el chip de rama abre el menú de ramas y worktrees:

• Worktrees — cada worktree del repo, con una marca en el que corresponde a esta fila; elige otro para abrirlo como su propia Ubicación. PullMark nunca hace checkout ni cambia de worktree — abre la carpeta que ya está ahí.
• Ver una rama desde GitHub — lee los archivos de otra rama en remoto, sin tocar tu checkout. Una rama que ya tiene worktree local salta al worktree — lo local gana a lo remoto.
• Abrir en GitHub — el repo (en esta rama) en tu navegador.

En un repo remoto (icono de libro), el mismo chip lista ramas: Cambiar a vuelve a fijar la sesión en otra rama y, manteniendo ⌥, aparece Abrir la rama por separado para leer lado a lado. Explorar los archivos del repo… carga el árbol Markdown completo del repo. Los docs conservados del repo van encima del árbol, para que nunca se ahoguen bajo un repo grande; un doc conservado que ya es visible en el árbol simplemente se representa ahí. (Un doc que solo estás previsualizando aparece en Archivos abiertos, no aquí.)

Una carpeta cuya ruta deja de resolverse (un volumen desmontado, un worktree borrado) se atenúa con una insignia de interrogación en vez de desaparecer — revive por sí sola cuando la ruta vuelve.

Pull Requests

Cada PR abierto es un grupo: la fila de resumen (icono de estado + número de archivos Markdown modificados) y luego sus archivos Markdown modificados — un globo de comentario con contador marca los archivos con hilos de revisión sin resolver. Bajo tus PR abiertos vienen los pull requests que te involucran, en categorías: Solicitudes de revisión, Creados, Asignados y Participando (comentaste, revisaste o te mencionaron). Las categorías vacías permanecen ocultas, los borradores dicen · borrador, y una fila explica por qué está ahí (· asignado, · mencionado) cuando la categoría por sí sola no basta. Cada categoría carga los 30 actualizados más recientemente y termina en Mostrar más…. Los contadores de no leídos siguen visibles en las cabeceras plegadas; todo el conjunto es opcional en Ajustes, y filtrable a solo los PR que tocan Markdown.

Sigue un repositorio para ver todo lo que está abierto en él, lo más nuevo primero: Seguir repositorio… en la cabecera de la sección ofrece los repositorios que ya tienes abiertos, o admite owner/repo escrito a mano. Un repositorio seguido es su propio grupo con su propia regla de no leídos — clic derecho en él para Todo, Solo los míos o Ninguno, y para Dejar de seguir. Cualquier fila de PR o issue puede anular esa regla desde su propio menú contextual.

¿Prefieres una sola lista? Agrupar el trabajo de GitHub por Participación fusiona esta sección e Issues en una sola sección GitHub, con categorías que mezclan ambos tipos con un glifo por fila.

Iconos de estado en las filas de PR:

Marcadores por archivo dentro de un PR: círculo + (verde) para añadido, círculo − (rojo) para eliminado, círculo → para renombrado, círculo con lápiz para modificado.

Issues

La misma idea para los issues — Creados, Asignados, Participando, y los issues de los repositorios seguidos — porque el doc que te piden revisar suele ser un issue, no un pull request. Haz clic en uno y se abre como un documento: el cuerpo renderizado, sus etiquetas, la cronología de comentarios con reacciones, y un cuadro de comentario al final. Comenta, reacciona, y edita o borra tus propios comentarios sin salir de la app. Un issue abierto ocupa la parte superior de la sección como una sola fila, entra en Recientes y en ⌘K Apertura rápida, y vuelve con la sesión.

Recientes

Archivos, carpetas y pull requests abiertos hace poco que no estén ya visibles arriba. Las entradas de PR llevan su icono de estado en vivo; un reciente cuyo archivo desapareció se atenúa (insignia de reloj) en vez de esfumarse y revive cuando la ruta vuelve — pensado para cambios de rama y volúmenes desmontados. Clic derecho en la cabecera para Vaciar recientes.

Quitar cosas

Pasa el cursor por cualquier fila de primer nivel para la ✕ — quita la fila de la barra lateral, jamás nada del disco ni de GitHub. ⌫ en una fila seleccionada hace lo mismo. Los archivos dentro del árbol de una Ubicación no tienen ✕: son contenidos de un lugar, no elementos de la barra lateral.

Glosario de iconos

El glifo de rama aparece solo en refs reales de git (chips, nunca como icono de carpeta) — una carpeta es una carpeta, un repo es un libro y una rama es una rama.