docs

La barre latérale

Sections organisées selon ce que les choses signifient plutôt que leur provenance : ce que vous avez ouvert, les lieux que vous gardez, les lieux que vous parcourez, les pull requests et issues qui vous concernent, et là où vous êtes passé.

Fichiers ouverts

Fichiers ouverts, c'est l'ensemble de travail : chaque document explicitement ouvert — depuis le Finder, par glisser-déposer, ⌘O, la ligne de commande, ou en gardant un fichier d'un emplacement. À plat, réordonnable en glissant, chaque ligne retirable avec le ✕ au survol (ou ⌫ sur la ligne sélectionnée). Clic droit sur l'en-tête de section pour Tout fermer.

Aperçus

Cliquez une fois un fichier dans un emplacement : il se rend immédiatement — et apparaît dans Fichiers ouverts en aperçu, une seule entrée en italique, toujours dernière de la section. Cliquez un autre fichier et l'entrée d'aperçu est remplacée : parcourir une grande arborescence n'empile jamais de lignes. C'est la même idée que les onglets d'aperçu de VS Code ou l'éditeur temporaire de Xcode, avec les mêmes italiques.

Un aperçu devient une entrée normale, épinglée, dès que vous lui montrez un engagement au-delà de la lecture :

• Double-cliquez le fichier dans l'arborescence, ou l'entrée italique elle-même
• Commencez à éditer — entrer en Mode édition ou enregistrer l'édition d'un bloc l'épingle
• Garder ouvert dans le menu contextuel

Les interactions de lecture — blame, historique de lignes, inspection d'une image ou d'un diagramme — ne promeuvent délibérément jamais un aperçu. Si vous préférez que chaque clic ouvre pleinement les fichiers, basculez « Clic sur un fichier dans Emplacements » dans Réglages.

Les dépôts distants s'aperçoivent de la même façon, au même endroit. Parcourir l'arborescence d'un dépôt GitHub, ou suivre des liens dans un document distant, place la même entrée italique unique dans Fichiers ouverts — avec une icône de livre et une seconde ligne owner/repo @ ref, puisque le fichier n'est pas sur votre Mac. Il n'y a jamais qu'un seul aperçu par fenêtre, local ou distant : apercevoir quoi que ce soit remplace ce que vous aperceviez avant. Garder un document distant (double-clic ou Garder ouvert) est ce qui le classe avec son dépôt — il rejoint la liste épinglée du dépôt sous Emplacements. ⌘K ouvre directement épinglé, coller une URL étant une intention explicite.

Toute ligne de Fichiers ouverts qui vit dans un emplacement ouvert gagne Afficher dans Emplacements dans son menu contextuel — le saut retour de « ce que je lis » vers « là où ça vit ».

Épinglés

Les dossiers et fichiers auxquels vous revenez sans cesse, au-dessus d'Emplacements — comme le Finder garde ses Favoris au-dessus de tout le reste. Clic droit sur un dossier ou un fichier dans n'importe quelle arborescence et choisissez Épingler… : un dossier devient sa propre racine avec sa propre arborescence, un fichier devient une ligne de signet qui s'affiche en aperçu au clic, et la nouvelle entrée atterrit en bas de la section, déjà en mode renommage. Une racine d'Emplacements gagne Épingler (elle se déplace ici) et une racine épinglée gagne Désépingler (elle se déplace en bas d'Emplacements, en gardant son nom).

Le renommage fonctionne comme dans le Finder : choisissez Renommer… ou appuyez sur Retour sur la ligne sélectionnée, tapez le nouveau nom : Retour, un clic ailleurs, ou le fait de passer à autre chose valide la saisie ; Échap annule ; un champ vidé revient au vrai nom. Une entrée renommée affiche son vrai chemin en petit texte sous le nom, tout comme toute paire de racines qui partagent un nom, pour que deux dossiers appelés docs ne se ressemblent jamais. Les entrées épinglées sont une préférence, pas une partie de la session : elles reviennent à chaque lancement quoi que dise Rouvrir la session précédente.

Emplacements

La section Emplacements regroupe les racines navigables, où qu'elles vivent. Deux espèces partagent la section, distinguées par l'icône :

Un dossier local qui est une copie de travail git gagne une pastille de branche (glyphe de branche + nom) ; si son remote est sur GitHub, une petite marque de livre fermé apparaît aussi — survolez-la pour voir quel dépôt. Cliquer la pastille de branche ouvre le menu branches-et-worktrees :

• Worktrees — chaque worktree du dépôt, avec une coche sur celui de cette ligne ; choisissez-en un autre pour l'ouvrir comme emplacement à part. Les worktrees ne sont jamais « checkout » ni basculés depuis PullMark — il ouvre le dossier qui est déjà là.
• Voir une branche depuis GitHub — lisez les fichiers d'une autre branche à distance, sans toucher à votre copie locale. Une branche qui a déjà un worktree local saute vers le worktree — le local l'emporte sur le distant.
• Ouvrir sur GitHub — le dépôt (à cette branche) dans votre navigateur.

Sur un dépôt distant (icône livre), la même pastille liste les branches : Basculer vers ré-épingle la session sur une autre branche, et maintenir ⌥ propose Ouvrir la branche à part pour une lecture côte à côte. Parcourir les fichiers du dépôt… charge toute l'arborescence Markdown du dépôt. Les docs gardées du dépôt siègent au-dessus de l'arborescence, pour ne jamais se noyer sous un gros dépôt ; une doc gardée visible dans l'arborescence y est simplement représentée. (Une doc simplement en cours d'aperçu s'affiche dans Fichiers ouverts, pas ici.)

Un dossier dont le chemin cesse de se résoudre (volume démonté, worktree supprimé) s'estompe avec un badge point d'interrogation au lieu de disparaître — il ressuscite tout seul quand le chemin revient.

Pull Requests

Chaque PR ouverte est un groupe : la ligne de vue d'ensemble (icône d'état + nombre de fichiers Markdown modifiés), puis ses fichiers Markdown modifiés — une bulle avec compteur marque les fichiers aux fils de révision non résolus. Sous vos PR ouvertes viennent les pull requests qui vous concernent, réparties en groupes : Demandes de révision, Créés, Assignés, et Participation (vous avez commenté, révisé, ou été mentionné). Les groupes vides restent masqués, les brouillons indiquent · brouillon, et une ligne précise pourquoi elle est là (· assigné, · mentionné) quand le groupe seul n'y suffit pas. Chaque groupe charge les 30 mises à jour les plus récentes et se termine par Afficher plus…. Les compteurs non lus restent visibles sur les en-têtes repliés ; le tout est optionnel dans Réglages, et filtrable aux seules PR touchant du Markdown.

Suivez un dépôt pour voir tout ce qui y est ouvert, du plus récent au plus ancien : Suivre le dépôt… dans l'en-tête de section propose les dépôts que vous avez déjà ouverts, ou accepte un owner/repo tapé directement. Un dépôt suivi est son propre groupe avec sa propre règle de non-lu — clic droit dessus pour Tout, Seulement les miens, ou Aucun, et pour Ne plus suivre. Toute ligne de PR ou d'issue peut modifier cette règle depuis son propre menu contextuel.

Vous préférez une seule liste ? Grouper le travail GitHub par Implication fusionne cette section avec Issues en une seule section GitHub, les groupes mélangeant les deux genres avec un glyphe par ligne.

Icônes d'état sur les lignes de PR :

Marqueurs par fichier dans une PR : cercle + (vert) pour ajouté, cercle − (rouge) pour supprimé, cercle → pour renommé, cercle crayon pour modifié.

Issues

Même logique pour les issues — Créés, Assignés, Participation, et les issues des dépôts suivis — parce que le document qu'on vous demande de réviser est souvent une issue, pas une pull request. Cliquez-en une et elle s'ouvre comme un document : le corps rendu, ses étiquettes, la chronologie des commentaires avec réactions, et un champ de commentaire à la fin. Commentez, réagissez, et modifiez ou supprimez vos propres commentaires sans quitter l'app. Une issue ouverte occupe le haut de la section en une seule ligne, rejoint Récents et ⌘K Ouvrir rapidement, et revient avec la session.

Récents

Récents : les fichiers, dossiers et pull requests récemment ouverts qui ne sont pas déjà visibles au-dessus. Les entrées de PR portent leur icône d'état en direct ; un récent dont le fichier a disparu s'estompe (badge horloge) au lieu de s'effacer, et ressuscite quand le chemin revient — pensé pour les changements de branche et les volumes démontés. Clic droit sur l'en-tête pour Effacer les récents.

Retirer des éléments

Survolez n'importe quelle ligne de premier niveau pour le ✕ — il retire la ligne de la barre latérale, jamais rien du disque ni de GitHub. ⌫ sur une ligne sélectionnée fait de même. Les fichiers dans l'arborescence d'un emplacement n'ont pas de ✕ : ce sont les contenus d'un lieu, pas des éléments de la barre latérale.

Glossaire des icônes

Le glyphe de branche n'apparaît que sur de vraies refs git (des pastilles, jamais comme icône de dossier) — un dossier est un dossier, un dépôt est un livre, une branche est une branche.