- GitHub Issues ist ein kostenloses und zugleich leistungsstarkes Tool für öffentliche/private Notizen und Zusammenarbeit
- Mit Markdown-Unterstützung, Syntax-Highlighting, Drag-and-drop für Bilder und Videos sowie Verlinkungsfunktionen bietet es ein hervorragendes Notizerlebnis
- Leistungsstarke Suche und Automatisierung, Backups sowie externe Anbindungen über die API sind möglich
- Der einzige wirkliche Nachteil ist das Fehlen einer synchronisierten Offline-Funktion: Ohne Netzwerkverbindung ist die Nutzung schwierig
- Checklisten, Verarbeitung großer Datenmengen, LLM-Integration, Datensicherung und Zuverlässigkeit sind weitere wichtige Vorteile
Der Wert von GitHub Issues für Notizen
- GitHub Issues kann man durchaus als fast bestes Online-Notizbuch bezeichnen
- Öffentliche wie private Notizen lassen sich kostenlos und unbegrenzt erstellen und verwalten
- Die Unterstützung für das Markdown-Format ist exzellent: Es gibt Syntax-Highlighting für nahezu alle Programmiersprachen, und Bilder lassen sich direkt in Notizen ziehen
Links und Verknüpfungsfunktionen
- Fügt man innerhalb eines Issues die URL eines anderen Issues als Markdown-Liste ein, wird der Titel automatisch geladen, und wechselseitige Links werden automatisch erstellt
- Dabei gelten die Sichtbarkeitsregeln der Issues, sodass private Issues nicht nach außen sichtbar werden
Starke Suche und API-Automatisierung
- Eine besondere Stärke ist die schnelle und präzise Suche innerhalb eines Repositorys, über alle eigenen Repositorys hinweg und über ganz GitHub
- Über die API lassen sich Notizdaten leicht exportieren sowie neue Notizen erstellen und bearbeiten
- Durch die Anbindung von GitHub Actions an Issue-Events lässt sich Automatisierung sehr umfassend umsetzen
Nachteil: keine Offline-Synchronisierung
- Der einzige Nachteil ist, dass ohne Internetverbindung keine Synchronisierung möglich ist
- Deshalb wird auf Mobilgeräten oft zusätzlich eine App mit Offline-/Sync-Unterstützung wie Apple Notes verwendet
Sicherheit, Komfort, Checklisten und Skalierbarkeit bei großen Datenmengen
- Sicherheitsbedenken sind eher gering. Unternehmen investieren in die Zuverlässigkeit von GitHub, und das Vertrauen in die Plattform ist hoch
- Auf jeder Notizplattform gibt es ein Risiko von Datenlecks durch Bugs, daher sollten keine sensiblen Daten gespeichert werden
- Da weder Bezahlmodell noch Self-Hosting erforderlich sind, ist das Risiko geringer, Notizen zu verlieren
- Markdown-Checklisten (
- [ ] item) und Issue-Referenzen (- [ ] #ref) sind äußerst nützlich
- Wird das betreffende Issue geschlossen, wird es automatisch als erledigt markiert
- Auch verschiedene Backup-Methoden (z. B. github-to-sqlite) lassen sich ausprobieren
- Die Skalierbarkeit ist ebenfalls hervorragend: Im vscode-Repository werden 190.000, im flutter-Repository über 100.000 Issues verwaltet
LLMs und weitere Einsatzmöglichkeiten
- Issue-Daten lassen sich auch problemlos in LLMs und andere generative KI-Systeme einspeisen
- Es gibt praktische Erfahrungen damit, einen Issue-Thread mit mehr als 50 Kommentaren über 1,5 Jahre zusammenzufassen und als neuen Kommentar aufzubereiten
Auswertung und Nutzung von Aktivitätsdaten
- Die Zahl der selbst auf GitHub erstellten Issues und Kommentare lässt sich per GraphQL-Abfrage auswerten
{
viewer {
issueComments {
totalCount
}
issues {
totalCount
}
}
}
- Das tatsächliche Ergebnis lag bei 9.413 Issues, 39.087 Kommentaren und zusammen 48.500 Einträgen
Fazit
- GitHub Issues punktet bei Kostenfreiheit, Zusammenarbeit, Automatisierung, Suche, Skalierbarkeit und praktischer Nutzbarkeit
- Wenn nur noch die Offline-Synchronisierung ergänzt würde, wäre es faktisch die beste digitale Notizbuch-Lösung
1 Kommentare
Hacker-News-Kommentare
Jemand berichtet, dass er bei der Vorbereitung seiner Hochzeit GitHub Issues als Projektmanagement-Tool genutzt hat. Seine Frau war anfangs skeptisch, aber dank Labels, Suche und ähnlichen Funktionen wurde die Zusammenarbeit sehr einfach, sodass sie die Aufgaben rechtzeitig abschließen konnten. Am schwierigsten war es wohl, per Lesezeichen einen direkten Link zum Issue-Tracker anzulegen. Kürzlich hat er GitHub Issues auch beim Umzug zum Organisieren von Kisten verwendet. Für jede Kiste wurde ein Issue angelegt, der Inhalt in die Beschreibung geschrieben und die Issue-Nummer auf die Kiste notiert, sodass sich später über die GitHub-Suche leicht herausfinden ließ, was sich in welcher Kiste befand
Frage aus Neugier, ob daneben auch andere Lösungen ausprobiert wurden und warum diese unzureichend waren
Die naheliegende Frage, ob man den Inhalt nicht einfach direkt außen auf die Kisten schreiben könnte
Das erinnert an ein auf Hacker News gesehenes Hausrenovierungsprojekt. Es scheint inzwischen von GitHub verschwunden zu sein; vorgestellt wird der entsprechende Projektlink
Im früheren Job wurde versucht, GitLab als vollständiges Projektmanagement-Tool zu nutzen, aber weil projektübergreifende Referenzen fehlten, kam die Einführung nicht weiter. Für Open-Source-Projekte sei es passend, aber im aktuellen Unternehmen könne GitLab YouTrack ersetzen und Upsource sei bereits ersetzt worden
Das erinnert an xkcd-Comic 1172. Solche unterhaltsamen Anekdoten gibt es viele, und es gibt erstaunlich viele Menschen mit absurd anmutenden Workflows. Solche Dinge seien mit einem richtigen Tool immer besser erledigt. Nebenbei wird erwähnt, dass bei einem Umzug ins Ausland Org mode zur Organisation der Aufgaben genutzt wurde. Persönliche Daten an Microsoft zu geben, komme für diese Person grundsätzlich nicht infrage
Ein interessanter Hinweis: Wenn man die folgende GraphQL-Abfrage in den GitHub GraphQL Explorer einfügt, kann man sofort die Gesamtzahl aller bisher auf GitHub erstellten Issues und Kommentare sehen
Die betreffende Person kommt auf insgesamt 48.500 Einträge, darunter 9.413 Issues und 39.087 Kommentare
Es wurde erwartet, dass der erste Kommentar das Thema Datenschutz anspricht, überraschenderweise war das aber nicht so. Die Person selbst hinterlässt nicht viele Notizen, hält sie aber für noch persönlicher als E-Mails. Solche privaten Daten möchte sie nicht zum Training von LLMs verwendet sehen. Es wird gefragt, welche Garantien Microsoft überhaupt in Bezug auf die Privatsphäre privater Repositories gibt
Da in GitHub Issues extrem sensible Unternehmensgeheimnisse enthalten seien, wird vermutet, dass Sicherheit und Privatsphäre sehr stark sein müssten. Viele Firmen zahlen GitHub viel Geld dafür, dort Quellcode und zugehörige Artefakte abzulegen, daher sei Vertrauensaufbau ein Kernbestandteil des Geschäftsmodells. Mit eigenen Geheimnissen Modelle zu trainieren, werde GitHub daher wohl nicht riskieren
Zu der Frage, ob „Microsoft die Privatsphäre privater Repositories garantiert“, wird eine zugehörige Diskussion hier verlinkt
Zweifel an der Behauptung, „GitHubs Suche ist großartig“. Als Beispiel wird genannt, dass ein Kommentar mit dem exakten Wortlaut „current logs could do with a bit of redesign“ nur gefunden wird, wenn die Phrase in Anführungszeichen gesetzt wird, und dass die Suche an Tippfehlern wie „redesing“ scheitert
Wie bei vielen anderen auch führt die Suche nach der besten Notiz-App am Ende immer wieder dazu, einfach Markdown-Dateien in ein Git-Repo zu legen
Falls man bei diesem Ansatz bleiben möchte, sei die Kombination aus Obsidian und Git Plugin die beste Erfahrung gewesen. Auf dem Desktop funktioniere das fantastisch, unter iOS sei jedoch etwas Einrichtung nötig
Der Vorschlag, einmal eine kostenlose Open-Source-Notiz-App auszuprobieren. Mit dem Hinweis, Kunde des Entwicklers zu sein, wird em als schöne, minimalistische Notiz-App für die Organisation persönlicher Gedanken vorgestellt
Im Vergleich zu Apps mit automatischer bidirektionaler Synchronisierung auf allen Geräten wirke ein Workflow, bei dem man bei jeder neuen oder geänderten Notiz manuell commit/push/pull ausführen muss, altmodisch
Eine weitere Person macht es ähnlich, verwendet aber statt Markdown Org-mode-Dateien und ergänzt bei Bedarf nach und nach org-roam-Tags
Jemand berichtet vom ständigen Hin und Her zwischen Apple Notes und einem Markdown-Ordner. Der Markdown-Ordner sei zukunftssicherer, aber Apple Notes überzeuge bei Design, Einfachheit und Medienunterstützung. Je mehr Funktionen eine Markdown-App unterstütze, desto geschlossener werde sie, und sogar Lese-Apps müssten all diese Funktionen unterstützen. Am Ende blieb die Person zwar bei Apple Notes, ist aber diesmal wieder dabei, per Hand mit Obsidian alles in einen Markdown-Ordner zu übertragen. Die Exportfunktion wurde genutzt, aber das Format sei chaotisch, sodass nun alle Notizen einzeln nachbearbeitet werden müssen
Mit der iCloud-Option „keep downloaded“ lassen sich nun alle Ordner und Dateien lokal speichern. Dadurch unterstützen alle Apps, die Dateien in iCloud speichern, sowohl Offline-Arbeit als auch automatische Online-Synchronisierung
Nachfrage zur Behandlung von Synchronisierungskonflikten und zum Synchronisierungsintervall
Es wird gefragt, ob iCloud beim Verschieben von Ordnern immer noch den Weg über Herunterladen und erneutes Hochladen nimmt
Als Alternativen zur Vermeidung von Vendor Lock-in werden Codeberg oder selbst gehostetes Forgejo genannt
Die Ansicht, dass GitHub Issues der beste Bugtracker bzw. das beste Ticketsystem ist. Gelobt werden die intuitive, einfache und schnelle Oberfläche. Eine gewisse Sorge besteht allerdings, dass ein Microsoft-Redesign es kaputtmachen könnte
Im Arbeitsalltag wurden viele Issue-Tracker verwendet, aber bei GitHub fehlten aus Sicht einer Person einige wichtige Funktionen. Genannt werden insbesondere: keine Möglichkeit, getrennt von den Kommentaren eine Issue-Zusammenfassung zu schreiben, fehlende erweiterte Zugriffskontrolle (bestimmte Issues lassen sich nicht nur für ausgewählte Personen sichtbar machen) und keine privaten persönlichen Notizen innerhalb eines Issues, um vorläufig etwas festzuhalten statt es öffentlich zu kommentieren
Azure DevOps wird metaphorisch als eine Art „Gravitationssenke“ beschrieben, die verhindern soll, dass Microsofts Marketingphilosophie in GitHub eingesogen wird
Es wird kritisiert, dass bereits eine Login-Schranke existiert und die Zahl frei durchsuchbarer Issues schnell begrenzt wird, wodurch die Offenheit abnehme
Schade sei, dass es keine Föderationsfunktion gebe. Eine Zentralisierung riesiger Quellcode-Speicher sei aus Sicht der gesamten Entwickler-Community etwas, das vermieden werden sollte. GitLabs Funktion für föderierte Merge Requests ( zugehöriges Issue ) macht seit neun Jahren keine Fortschritte. Allein diese Funktion würde es ermöglichen, wie bei git zusammenzuarbeiten, ohne dass alle ein zentralisiertes System nutzen müssten. Außerdem wird auf einen Vorfall verwiesen, bei dem Microsoft auf Anweisung der US-Regierung das E-Mail-Konto des Chefanklägers des Internationalen Strafgerichtshofs gesperrt habe. Die Ironie sei groß, da das kurz nach Aussagen passiert sei, man werde sich der Europäischen Union entgegenstellen. Wenn Trump die EU so wenig leiden könne, dann könne er Microsoft eines Tages auch anweisen, den EU-Zugang zu GitHub zu sperren. Es sei wichtig, sich die Auswirkungen eines solchen Szenarios auf Unternehmen und Open Source klarzumachen
Nicht nur chinesische, auch US-Technologie sei als vertrauenswürdige Grundlage instabil geworden; öffentliche Einrichtungen und Regierungen müssten ihre Abhängigkeit von Technologien einzelner Länder unbedingt überdenken
Man würde gern Alternativen wie Radicle ausprobieren. Wenn man erst anfängt, wenn die Lage noch schlimmer geworden ist, werde man es am Ende wahrscheinlich bereuen
Fast wie Obsidian, nur mit etwas mehr Prozedere
Einer dieser zusätzlichen Schritte könnte ja auch darin bestehen, „50 Dollar pro Jahr zu zahlen, um auf allen Geräten Zugriff zu haben“, oder „100 Dollar pro Jahr für Webzugriff“ — als scherzhafte Bemerkung
Tatsächlich wirke auch Obsidian wie Textdateien mit etwas zusätzlichem Prozedere. Aber Textdateien an sich seien ausgesprochen mächtig, und es gebe viele Möglichkeiten zur Synchronisierung zwischen Geräten
Anders als Obsidian ist GitHub Issues nur online nutzbar. Wenn kein Backup möglich ist, ist das ganz klar ein Problem
Die Frage, ob sich Obsidian selbst hosten lässt. Für die berufliche Nutzung bestünden Sicherheitsbedenken, daher der Vorschlag, alles lokal zu halten und nur die Markdown-Dateien über OneDrive zu sichern