DevGlossary: Strukturiertes Markdown-Glossar technischer Begriffe für Entwickler
DevGlossary ist ein Open-Source-Repository mit Programmierbegriffen, sortiert nach Themen im Markdown-Format. Jeder Eintrag enthält eine Definition, Anwendungsfälle, Einschränkungen und Verweise auf verwandte Konzepte. Das Projekt löst das Problem vager Kenntnisse, indem es Begriffe wie Komposition vs. Aggregation, Concurrency vs. Parallelität oder bounded context in einem einheitlichen Format standardisiert – ideal für schnelle Nachschlage oder vertiefte Auseinandersetzung.
Das Glossar basiert auf den persönlichen Notizen des Autors, wurde mit GPT strukturiert und einheitlich formatiert. Es eignet sich perfekt für Mid-Level- und Senior-Entwickler, um Interpretationen abzustimmen, ohne lange Artikel durchzulesen.
Themenstruktur und Eintragsformat
Themen sind in separate Dateien unterteilt: Architektur, OOP, Funktionale Programmierung, Laufzeit und Speicher, Concurrency, Algorithmen und Datenstrukturen, Datenbanken, Netzwerke, Compiler und Sprachen, Testing, DevOps, Sicherheit. Jedes Thema folgt einem festen Template:
- Inhaltsverzeichnis.
- Liste der Begriffe mit kurzen Definitionen.
- Detaillierte Eintragskarten.
Eine Begriffskarte umfasst:
- Kurze Definition.
- Vollständige Definition.
- Zweck.
- Wann einsetzen.
- Einschränkungen und Fallstricke.
- Beispiele.
- Verwandte Begriffe.
Diese Struktur ermöglicht zwei Modi: Schnellsuche (1 Minute) und vollständige Themenkontext-Wiederherstellung.
Vorteile des Markdown-Formats
Markdown wurde wegen seiner Einfachheit gewählt:
- Direkt auf GitHub anzeigbar, ohne Konvertierung.
- In jedem Texteditor bearbeitbar.
- Einfache Pull Requests.
- Exportierbar als Website, PDF oder DOCX.
Repository-Struktur:
DevGlossary/
├─ README.md
├─ INDEX.md
├─ assets/
│ └─ cover.png
└─ topics/
├─ _template.md
├─ architecture.md
├─ oop.md
└─ ... (weitere Themen)
INDEX.md dient als Einstiegspunkt mit Navigation. _template.md gewährleistet Einheitlichkeit.
Zielgruppe und Nutzen
Das Projekt richtet sich an:
- Entwickler, die Terminologie systematisieren.
- Tech Leads und Architekten, die Konzepte teamübergreifend vereinheitlichen.
- Spezialisten, die präzise Definitionen ohne lange Lektüre brauchen.
Das Glossar erfrischt das Gedächtnis, verknüpft Ideen und vermeidet Verwechslungen (z. B. Idempotenz mit optimistischem Locking oder Concurrency mit Parallelität). Es ersetzt keine offiziellen Docs, beschleunigt aber den Zugriff auf wesentliche Nuancen.
Entwicklungsfahrplan
Das Kernframework ist fertig. Nächste Schritte:
- Formulierungen für mehr Konsistenz verfeinern.
- Querverweise ausbauen.
- Weitere Begriffe zu Abschnitten hinzufügen.
- Große Themen aufteilen (Datenbanken, Concurrency, Architektur).
Prioritäten: Datenbanken, Concurrency, Architektur, Netzwerke.
Wichtige Punkte:
- Einheitliches Kartenformat für Übersichtlichkeit.
- Markdown für einfache Beiträge.
- Fokus auf Nuancen und Begriffsverknüpfungen.
- Offener PR-Prozess für Verbesserungen.
- Zwei Modi: Schnellnachschlage und Konzeptmapping.
— Editorial Team
Noch keine Kommentare.