Repository navigation
docmap-desktop v0.3.0
Die Ebene über einem einzelnen Projekt — und eine Engine, die dreiundzwanzig
Sprachen liest und beim Erklären hilft, statt nur aufzulisten.
Der Workspace beantwortet jetzt die Frage, die nur er beantworten kann
Mit nichts ausgewählt listet das Fenster jedes Projekt des Workspace und
ordnet sie danach, was zu tun ist. Dieser Zustand ist kein fehlendes Thema,
er ist der Workspace — und ein Bildschirm, der „wähle links ein Projekt"
sagte, war die App dabei, die eine Frage nicht zu beantworten, die nur sie
beantworten kann.
Die Rangfolge ist gemessen, nicht gewählt. Über 54 Repositories, 30 mit
erzeugter Karte: 27 stammten von Schema 2, während die Engine 5 schreibt.
Eine ältere Engine bedeutet konkret fehlende Inhalte, „veraltet" dagegen
zeigte bei 17 von 28 Fällen auf ein .gitignore aus einem einzigen Rutsch.
Deshalb führt die Engine-Version. Die naheliegende Ordnung — neuste Änderung
zuerst — ist die, die die Zahlen verworfen haben.
Dazu Veraltete erzeugen als Sammelaktion im Menü.
Was hängt woran
Ein lesender Konsument über alle Karten des Workspace: requires_external
hält fest, dass ein Modul außerhalb des Repositorys verlangt wurde, und kann
nicht sagen, wo es lebt — sie hat es nie gesehen. Mehrere Karten können es,
und dieses Fenster ist der einzige Ort, an dem mehrere liegen.
Gemessen über 30 erzeugte Karten: 1 820 deklarierte Modulnamen, kein einziger
von zwei Repositories beansprucht. Ein Treffer ist damit eine Tatsache, kein
Raten.
Zweisprachig
Die Dialoge, die Hinweise und die langen Menüeinträge sprechen jetzt beide
Sprachen — nicht nur die Menüleiste.
Der Dateibaum sagt, was git von einem Eintrag hält
Neben dem, was der Scan getan hat: nicht versioniert, ignoriert, übersprungen
oder ein verschachteltes Repository — jeweils mit dem Grund, statt mit einem
grauen Eintrag ohne Erklärung.
Die eingebaute Engine gewinnt gegen eine zufällige auf dem PATH
Vorher nicht: ein älteres docmap.exe auf dem PATH hatte still Vorrang, und
die App sah richtig aus, während sie eine zwei Tage alte Engine mit vier
statt dreiundzwanzig Sprachen fuhr. Die Seitenleiste sagt jetzt, welche läuft.
Die mitgelieferte Engine — siebzehn Commits weiter
Sie erklärt sich selbst
Jeder Ansichtsknopf und jeder Analyse-Reiter trägt eine Erklärung, was er
zeigt und was er nicht behauptet — als Karte, nicht als title-Attribut, das
auf einem Touchgerät nie erscheint und einen Screenreader zweimal dasselbe
sagen lässt.
Inline-Code in Beschreibungen wird als Code gesetzt — auf der erzeugten Seite
und im Detailbereich von :DocBrowse. Gemessen: 2 132 Inline-Spannen gegen
vier Zaunblöcke, was die Gewichtung des Entwurfs umgedreht hat.
K erklärt ein Wort — aber nur dort, wo es Code ist
Im Browser: die Glossarkarte für das Wort unter dem Cursor. Nur innerhalb
einer `code`-Spanne, und das ist gezählt: ein Glossarbegriff steht
213-mal in einer Spanne und 2 558-mal in englischer Prosa („and", „for",
„in", „end"). Ein K, das überall antwortet, läge zwölf von dreizehn Malen
daneben — mit einer korrekten Definition am falschen Wort.
Dabei fiel auf, dass der Detailbereich gar nicht fokussierbar war: zwei von
sechzehn Einträgen rendern 46 Zeilen in einen 14-Zeilen-Bereich, ohne Weg zum
Rest. w behebt beides.
Lua wird mit Doppelpunkt geschrieben, das Glossar kannte nur Punkte
s:gsub(…) traf nichts, weil die Einträge nach Punktnamen verschlüsselt
waren. Gezählt über dieselben Snippets: 1 004 Doppelpunkt-Aufrufe gegen 6
mit Punkt für dieselben elf Funktionen — die häufigste Aufrufform der
Sprache war für ein Feature unsichtbar, dessen Zweck das Erklären von
Stdlib-Aufrufen ist. +934 Dekorationen.
63 % einer echten Config waren für den Plugin-Scanner unsichtbar
core/plugins.lua las nur das return { … } einer Datei. Eine Config, die
über plugins.add({ … }) registriert, trug nichts bei — schweigend.
Gemessen: 52 Specs gefunden, 85 nach Deklaration des einen Wrappers, die
fehlenden 33 in einer einzigen 906-Zeilen-Datei.
opts.plugins.wrappers deklariert den Helfer. Damit lesen sich auch packer,
vim-plug und mini.deps — geschätzt als drei eigene Extraktoren, tatsächlich
neun Zeilen, weil alle drei über einen Aufruf registrieren, den der
Wrapper-Lauf schon liest.
Ein Lazy-Load-Inventar
Welches Plugin lädt auf welches Event, welchen Dateityp, welchen Befehl,
welche Taste — und was beim Start liegt. Die Messung hat den Entwurf
korrigiert: 7 von 52 Specs standen unter dem falschen Ladezustand, weil
lazy = true ohne jeden Trigger gelesen wurde, als lüde es später. Es lädt
nie. Drei Zustände statt zwei.
Zwei Duplikate nebeneinander in Compiler Explorer
Ein Klick öffnet beide markierten Funktionen in einer Sitzung. Gemessen
über 232 Duplikatgruppen in 27 Repositories: 144 haben genau zwei Mitglieder
— ein Paar ist der Normalfall. „Ganze Gruppe kompilieren" wäre ausgerechnet
bei den Gruppen gescheitert, die man am ehesten ansieht (8-KB-Grenze der
Anfragezeile). Eine eigene Instanz lässt sich eintragen; sie liegt im
localStorage, nie im Artefakt, und die Warnung wird für localhost
umgeschrieben statt umetikettiert.
:DocMap pick
Der Name, den du kennst, und die Zeile, in der er lebt — mit vier
Sortierungen.
Kleineres, das trotzdem auffällt
- Ein Klick auf die Hierarchie hält die Ansicht, der zweite handelt.
- Links in einer Zusammenfassung folgen ihr ins Artefakt.
- Ein Gate, das übersprungen wurde, gilt nicht mehr als bestanden.
runtime-analysis.nvim
proc_trace kann jetzt exakt benannt werden, und die Warnung „das kennt nur
die eigenen Wraps" erscheint nicht mehr dort, wo sie unwahr ist.