- GitHub Issues est un outil gratuit et puissant pour les notes publiques/privées et la collaboration
- La prise en charge de Markdown, la coloration syntaxique du code, le glisser-déposer d’images et de vidéos, ainsi que l’interconnexion entre éléments offrent une excellente expérience de prise de notes
- Il permet une recherche puissante et l’automatisation, les sauvegardes et les intégrations externes via l’API
- Son seul vrai point faible est l’absence de mode hors ligne synchronisé, ce qui le rend difficile à utiliser sans connexion réseau
- Les checklists, la gestion de gros volumes, les usages liés aux LLM, ainsi que la sauvegarde et la fiabilité des données font aussi partie de ses grands atouts
L’intérêt d’utiliser GitHub Issues pour les notes
- GitHub Issues peut être considéré comme un des tout meilleurs carnets de notes en ligne
- Il permet de créer et gérer gratuitement un nombre illimité de notes publiques et privées
- La prise en charge du format Markdown est excellente, avec coloration syntaxique pour presque tous les langages de programmation, et il est aussi possible de glisser directement des images dans une note
Liens et interconnexion
- Lorsqu’on ajoute l’URL d’une autre issue dans une liste Markdown à l’intérieur d’une issue, son titre est récupéré automatiquement et des liens réciproques sont créés
- Les règles de visibilité des issues s’appliquent, de sorte qu’une issue privée n’est pas exposée à l’extérieur
Recherche puissante et automatisation via l’API
- La recherche rapide et précise à l’échelle d’un dépôt, de tous les dépôts d’un utilisateur ou de l’ensemble de GitHub est l’un de ses points forts
- L’API permet d’exporter facilement les données de notes, ainsi que de créer ou modifier de nouvelles notes
- En connectant les événements d’issue à GitHub Actions, il est aussi possible de mettre en place une automatisation très étendue
Inconvénient : absence de synchronisation hors ligne
- Son unique défaut est l’absence de synchronisation lorsqu’il n’y a pas de connexion Internet
- Pour cette raison, sur mobile, on finit souvent par l’utiliser avec une application prenant en charge le hors ligne et la synchronisation, comme Apple Notes
Sécurité, confort d’usage, checklists et montée en charge
- Les inquiétudes en matière de sécurité restent limitées. Les entreprises investissent dans la fiabilité de GitHub, et la confiance dans la plateforme est élevée
- Toutes les plateformes de notes présentent un risque de fuite lié à des bugs, donc il vaut mieux ne pas y stocker de données sensibles
- Comme il n’y a ni facturation ni auto-hébergement nécessaires, le risque de perdre ses notes est plus faible
- Les checklists Markdown (
- [ ] item) et les références à des issues (- [ ] #ref) sont particulièrement utiles
- Lorsque l’issue concernée est fermée, la case est cochée automatiquement
- Il est aussi possible d’essayer différentes méthodes de sauvegarde (par ex. github-to-sqlite)
- La capacité de montée en charge est également excellente, avec des exemples de gestion de plus de 190 000 issues dans le dépôt vscode et plus de 100 000 dans le dépôt flutter
LLM et autres usages
- Il est aussi très simple de connecter les données d’issues en pipeline à des IA génératives comme les LLM
- Il y a eu en pratique l’expérience de résumer un fil d’issue de 1,5 an comptant plus de 50 commentaires, puis d’en faire un nouveau commentaire de synthèse
Agrégation et exploitation des données d’activité
- Il est possible d’agréger via une requête GraphQL le nombre d’issues et de commentaires créés sur GitHub
{
viewer {
issueComments {
totalCount
}
issues {
totalCount
}
}
}
- Les résultats réels sont de 9 413 issues, 39 087 commentaires, soit un total de 48 500 éléments à son nom
Conclusion
- GitHub Issues se distingue par la gratuité, la collaboration, l’automatisation, la recherche, la montée en charge et la polyvalence
- Si la synchronisation hors ligne était ajoutée, ce serait de fait l’une des meilleures solutions de carnet de notes numérique
1 commentaires
Avis Hacker News
Partage d’une expérience passée consistant à utiliser GitHub Issues comme outil de gestion de projet pour préparer son mariage. Au départ, son épouse était sceptique, mais l’ajout de labels, la recherche et d’autres fonctions ont rendu la collaboration très simple, ce qui leur a permis de terminer les tâches de préparation à temps. Le plus difficile, de mémoire, avait été de créer un lien direct vers l’issue tracker dans les favoris. Plus récemment, lors d’un déménagement, GitHub Issues a aussi servi à organiser les cartons. Il suffisait de créer une issue pour chaque carton, d’écrire son contenu dans la description, puis de noter le numéro de l’issue sur le carton pour pouvoir retrouver facilement plus tard, via la recherche GitHub, quel carton contenait quoi
Question par curiosité : est-ce que d’autres solutions ont été essayées, et pourquoi étaient-elles insuffisantes ?
Simple question : pourquoi ne pas simplement écrire directement le contenu sur l’extérieur du carton ?
Cela rappelle une histoire vue sur Hacker News à propos d’un projet de rénovation de maison. Il semble avoir disparu de GitHub aujourd’hui, mais voici le lien vers le projet en question
Dans un précédent emploi, une tentative avait été faite d’utiliser GitLab comme outil de gestion de projet global, mais l’adoption s’était arrêtée à cause de l’absence de références entre projets. Bien adapté aux projets open source, mais dans l’entreprise actuelle, GitLab peut remplacer YouTrack et a déjà remplacé Upsource
Cela fait penser au comic xkcd n°1172. Il existe beaucoup d’anecdotes amusantes de ce genre, et pas mal de gens ont des workflows absurdes. Il vaut toujours mieux traiter ce genre de choses avec un outil adapté. À noter aussi une expérience personnelle d’organisation d’un déménagement international avec Org mode. Tempérament totalement opposé à l’idée de confier des données personnelles à Microsoft
Fait amusant : si vous collez la requête GraphQL ci-dessous dans le GitHub GraphQL Explorer, vous pouvez voir immédiatement le nombre total d’issues et de commentaires que j’ai publiés sur GitHub jusqu’à présent
Pour ma part : 9 413 issues, 39 087 commentaires, soit 48 500 au total
On s’attendait à ce que le premier commentaire porte sur la protection de la vie privée, mais étonnamment non. Je prends peu de notes, mais je considère cela comme des données encore plus personnelles que les e-mails. Je n’aimerais pas que ce type d’informations serve à entraîner des LLM. Je me demande quelles garanties Microsoft donne réellement sur la confidentialité des private repositories
Vu la quantité d’informations extrêmement sensibles et confidentielles stockées dans GitHub Issues par les entreprises, on peut supposer que la sécurité et la confidentialité y sont très solides. De nombreuses sociétés confient à GitHub leur code source et les artefacts associés, et paient cher pour cela ; la confiance est donc au cœur de son modèle économique. Selon cet avis, GitHub ne prendrait pas le risque d’entraîner des modèles sur ces secrets internes
À propos de la question « Microsoft garantit-il la confidentialité des private repositories ? », voici une discussion liée ici
Mise en doute de l’affirmation selon laquelle « la recherche de GitHub est excellente ». Par exemple, même s’il existe un commentaire contenant exactement « current logs could do with a bit of redesign », il faut l’entourer de guillemets pour le retrouver, et une simple faute de frappe (comme « redesing ») suffit à faire échouer la recherche
Comme moi, beaucoup de gens essaient de trouver l’application de notes ultime, puis finissent toujours par revenir à une accumulation de fichiers Markdown dans un dépôt Git
Si l’on veut continuer avec cette approche, la combinaison Obsidian + Git Plugin a été la meilleure expérience. Cela fonctionne fantastiquement sur desktop, mais demande un peu de configuration sur iOS
Suggestion d’essayer une application de notes gratuite et open source. En précisant être client de l’éditeur, présentation de em comme une application de notes belle et minimaliste pour organiser sa pensée personnelle
Avis selon lequel devoir faire manuellement commit/push/pull à chaque nouvelle note ou note modifiée semble vieillot, comparé aux applications qui proposent une synchronisation bidirectionnelle automatique sur tous les appareils
Même logique ici, sauf qu’on utilise des fichiers Org-mode au lieu de Markdown, en ajoutant au besoin quelques tags org-roam petit à petit
Partage d’une expérience pénible à faire des allers-retours entre Apple Notes et un dossier Markdown. Le dossier Markdown est meilleur pour la compatibilité future, mais Apple Notes excelle par son design, sa simplicité et sa prise en charge des médias. Plus une app Markdown prend en charge de fonctions, plus elle devient fermée, et même les apps de lecture doivent alors les supporter. Au final, décision de rester sur Apple Notes, tout en refaisant encore une migration manuelle vers un dossier Markdown avec Obsidian. L’export a été utilisé, mais le format est tellement mauvais qu’il faut reprendre toutes les notes une par une
Avec l’option « keep downloaded » d’iCloud, il est désormais possible de conserver tous les dossiers et fichiers en local. Par conséquent, toutes les applications qui stockent leurs fichiers sur iCloud prennent en charge à la fois le travail hors ligne et la synchronisation automatique en ligne
Question sur la gestion des conflits de synchronisation et sur la fréquence de synchronisation
Demande de confirmation sur le fait qu’en cas de déplacement d’un dossier, iCloud utilise encore une logique de téléchargement puis de réupload
Présentation d’alternatives pour éviter le vendor lock-in : utiliser Codeberg ou héberger soi-même Forgejo
Opinion selon laquelle GitHub Issues est le meilleur bug tracker / système de tickets. Éloge d’une interface intuitive, simple et rapide. Petite inquiétude néanmoins : que tout soit gâché par une future refonte signée Microsoft
Retour d’expérience professionnel après avoir utilisé plusieurs issue trackers : GitHub manque selon cette personne de certaines fonctions importantes. En particulier, l’impossibilité d’écrire un résumé d’issue séparé des commentaires, l’absence de contrôle d’accès avancé (impossible de rendre certaines issues visibles seulement à certaines personnes), et l’absence de notes privées temporaires en plus des commentaires publics
Formulation imagée selon laquelle Azure DevOps serait une sorte de « puits gravitationnel » conçu pour empêcher que la philosophie marketing de Microsoft soit absorbée dans GitHub
Remarque indiquant que l’ouverture a déjà reculé, avec l’apparition d’un mur de connexion et une limitation rapide du nombre d’issues consultables via la recherche
Regret de l’absence de fédération. La centralisation de grands dépôts de code est considérée comme une structure à éviter pour l’ensemble de la communauté des développeurs. La fonctionnalité de merge requests fédérées de GitLab (issue associée) n’a toujours pas avancé après neuf ans. Avec cette seule fonction, tout le monde pourrait collaborer comme avec git sans dépendre d’un système centralisé. Est aussi rappelé un épisode récent où Microsoft a bloqué le compte e-mail du procureur de la Cour pénale internationale sur ordre de l’administration américaine. Une ironie, peu de temps après une communication affirmant vouloir tenir tête à l’Union européenne. Si un jour Trump demandait à Microsoft de couper l’accès européen à GitHub, l’entreprise pourrait le faire. Avertissement : il faut bien réfléchir aux conséquences potentielles pour les entreprises et l’open source
Avis selon lequel la fiabilité des technologies américaines, et pas seulement chinoises, est devenue incertaine ; les institutions publiques et les gouvernements devraient impérativement reconsidérer leur dépendance aux technologies d’un pays particulier
Envie d’essayer des alternatives comme Radicle. L’idée est qu’attendre que la situation empire encore risque seulement de provoquer des regrets plus tard
C’est presque comme Obsidian, mais avec un peu plus d’étapes
Plaisanterie : l’une de ces étapes pourrait être de payer 50 $ par an pour avoir accès sur tous ses appareils, ou 100 $ par an pour un accès web
En réalité, Obsidian aussi ressemble à des fichiers texte avec quelques étapes supplémentaires. Mais au fond, les fichiers texte eux-mêmes sont extrêmement puissants, et il existe de nombreuses façons de les synchroniser entre appareils
Contrairement à Obsidian, GitHub Issues est uniquement en ligne. S’il n’est pas possible d’en faire des sauvegardes, c’est clairement un problème
Question sur la possibilité d’auto-héberger Obsidian. Pour un usage professionnel, il y a des inquiétudes de sécurité, d’où la suggestion de tout garder en local et de ne sauvegarder que les fichiers Markdown via OneDrive