Skip to content

docmap-desktop v0.3.0

Choose a tag to compare

@github-actions github-actions released this 21 Aug 03:06
· 159 commits to baeef511eea9a6cc66f56efa4a0f9ca17cf02614 since this release

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.