Zum Inhalt springen
Für Entwickler

Die Begründung hinter dem Code, direkt neben dem Code

Jede Codebasis hat eine zweite Hälfte, die in den Köpfen der Leute steckt: warum diese Zahl an Wiederholungen, warum dieser Fallback, warum der naheliegende Weg verworfen wurde. Sie geht, wenn die Leute gehen.

Zwanzig Sprachen, als Code indexiert

Symbole und die Aufrufe zwischen ihnen landen im selben Graphen wie deine Notizen, nicht in einem eigenen Suchfeld. Eine Entscheidungsnotiz und die Funktion, die daraus entstand, werden zu Nachbarn — weil sie genau das sind.

Die git-Historie liegt neben den Notizen im Index

Was sich geändert hat, wann, und was damals dazu geschrieben wurde — alles mit einer einzigen Frage erreichbar. Der Commit sagt dir, was passiert ist, die Notiz sagt dir, warum; für sich allein nützt keines von beiden viel.

Die Sprengweite, bevor du etwas anfasst

Frag, was von einem Symbol abhängt, und die Antwort kommt aus dem Graphen statt aus einer Textsuche, die jeden Kommentar findet, in dem der Name vorkommt. Nützlich genau dann, wenn dir der Code fremd ist — also genau dann, wenn du sie brauchst.

Wie das aussieht

Du erbst einen Dienst und findest eine magische Zahl

Sieben Wiederholungen. Kein Kommentar. git blame zeigt auf einen Commit mit der Nachricht „fix flakiness“.

Du fragst, warum die Zahl der Wiederholungen sieben ist. Die Antwort zitiert eine Entscheidungsnotiz von vor achtzehn Monaten — das Timeout des Datenspeichers wurde unter Last mit sechs Sekunden gemessen, sieben Wiederholungen deckten den schlimmsten beobachteten Fall mit Reserve ab, und mit dreien kam der Fehler zurück — und daneben die Funktion, die das umsetzt, und der Test, der es festschreibt.

Du weißt jetzt, ob du sie ändern kannst. Die Alternative war: ändern, ausliefern und es dann herausfinden.

Bevor du etwas Echtes hineinlegst

Kann ich das mit meinen Daten nutzen?

Gesucht wird lokal. Geantwortet wird dort, wohin du zeigst.

Die passenden Stellen zu finden passiert immer auf deinem Rechner. Was danach geschieht, entscheidest du: Verbindest du ein Cloud-Modell, gehen die gefundenen Stellen an diesen Anbieter — genau so, wie wenn du sie selbst dort hineinkopiert hättest. Richtest du es auf ein lokal laufendes Modell, verlässt überhaupt nichts den Rechner. Diese zweite Möglichkeit gibt es heute, und sie macht aus der Frage „wo werden unsere Daten verarbeitet?“ die Antwort „auf deinem Gerät“.