DevGlossary: uporządkowany słownik terminów inżynieryjnych w Markdown dla programistów
DevGlossary to otwarty repozytorium z terminami programistycznymi, zorganizowanymi tematycznie w formacie Markdown. Każda pozycja zawiera definicję, zastosowanie, ograniczenia i powiązania z innymi pojęciami. Projekt rozwiązuje problem niejasnych definicji: terminy takie jak kompozycja vs agregacja, równoległość vs współbieżność czy ograniczony kontekst są ujednolicone w spójnym formacie – idealne do szybkiego sprawdzenia lub głębszej analizy.
Słownik powstał na bazie osobistych notatek autora, uzupełnionych przez GPT dla struktury, z ujednoliconym formatem. Przeznaczony dla programistów średniego i zaawansowanego poziomu do weryfikacji interpretacji bez czytania całych artykułów.
Struktura tematów i format wpisów
Tematy rozdzielone na pliki: Architektura, Programowanie obiektowe, Funkcyjne, Środowisko uruchomieniowe i pamięć, Współbieżność, Algorytmy i struktury danych, Bazy danych, Sieci, Kompilatory i języki, Testowanie, DevOps, Bezpieczeństwo. Każdy temat podąża schematem:
- Spis treści.
- Lista terminów z krótkimi definicjami.
- Szczegółowe karty.
Karta terminu zawiera:
- Krótka definicja.
- Pełna definicja.
- Przeznaczenie.
- Kiedy stosować.
- Ograniczenia i błędy.
- Przykłady.
- Powiązane terminy.
Dzięki temu dwa tryby użycia: szybkie wyszukiwanie (1 minuta) i odświeżenie kontekstu tematu.
Zalety formatu Markdown
Markdown wybrany za prostotę:
- Odczyt w GitHub bez konwersji.
- Edycja w dowolnym edytorze.
- Łatwe zgłaszanie PR.
- Eksport do strony, PDF lub DOCX.
Struktura repozytorium:
DevGlossary/
├─ README.md
├─ INDEX.md
├─ assets/
│ └─ cover.png
└─ topics/
├─ _template.md
├─ architecture.md
├─ oop.md
└─ ... (pozostałe tematy)
INDEX.md to punkt wejścia z nawigacją. Szablon _template.md zapewnia jednolitość.
Grupa docelowa i wartość
Projekt dla:
- Programistów systematyzujących terminologię.
- Team leadów i architektów do ujednolicenia pojęć w zespole.
- Specjalistów potrzebujących precyzyjnych sformułowań bez długich tekstów.
Słownik odświeża wiedzę, łączy pojęcia, unika pomyłek (idempotencja z optymistycznym blokowaniem, współbieżność z równoległością). Nie zastępuje dokumentacji, ale przyspiesza dostęp do niuansów.
Plany rozwoju
Podstawowa struktura gotowa. Dalej:
- Ujednolicenie sformułowań.
- Wzmocnienie linków krzyżowych.
- Dodanie terminów do sekcji.
- Podział dużych tematów (Bazy danych, Współbieżność, Architektura).
Priorytet: bazy danych, współbieżność, architektura, sieci.
Co ważne:
- Jednolity format kart dla spójności.
- Markdown dla niskiego progu wkładu.
- Nacisk na niuanse i powiązania terminów.
- Otwarty proces PR dla ulepszeń.
- Dwa tryby: spisownik i mapa koncepcji.
— Editorial Team
Brak komentarzy.