Ich konnte keinen PR einreichen, also bin ich direkt zu Mintlify gewechselt und habe es selbst behoben

 (skeptrune.com)
6 Punkte von GN⁺ 2025-08-03 | 3 Kommentare | Auf WhatsApp teilen
  • Ich habe das Race-Condition-Problem in der Mintlify-Suche über ein Jahr hinweg erlebt und konnte es nicht verbessern, was ich als störend empfand
  • Obwohl ich Gründer von Trieve, dem Suchmaschinenanbieter von Mintlify, bin, hatte ich als Vendor keinen direkten Codezugriff und konnte das Problem nicht selbst beheben
  • Nachdem ich zu Mintlify kam, habe ich AbortController genutzt, um die Unterbrechung laufender Suchabfragen und ein Ergebnis-Synchronisations-Problem zu lösen
  • Der praktische Vorteil von Open Source liegt darin, dass dieser Fix per PR sofort möglich gewesen wäre
  • Selbst bei kleinen Unannehmlichkeiten spürt man beim direkten Beheben die Zufriedenheit und wie wichtig die Verbesserung eines Produkts ist

Ich konnte keinen PR einreichen und habe ihn deshalb direkt vor Ort verbessert

Über ein Jahr lang störender Mintlify-Suchfehler

  • In der Suchfunktion von Mintlify führt eine Race Condition dazu, dass Abfragen doppelt verarbeitet werden und beim Tippen falsche Suchergebnisse angezeigt werden
  • Trieve, der Anbieter der Suchtechnologie für Mintlify, war zwar mein Unternehmen als Gründer, aber als Vendor (externer Partner) hatte ich keinen Zugriff auf die Codebase und konnte den Fehler nicht selbst beheben
  • Ich habe das Problem mehrfach im gemeinsamen Slack-Kanal angesprochen, aber wegen niedriger Priorität wurde es lange liegen gelassen
  • Immer wenn die Trieve-Suche bei Mintlify schwächer wirkte, hatte ich als Gründer ein Gefühl von persönlichem Druck wegen meines Egos und der Markenwahrnehmung

Beim Team direkt mit anpacken

  • Durch den Einstieg bei Mintlify bekam ich direkten Zugriff auf die Codebase
  • In die Suchfunktion habe ich den AbortController eingebaut, sodass vorherige Suchanfragen sofort abgebrochen werden
  • Jetzt wird beim Tippen nur noch das aktuellste Suchergebnis übernommen, daher werden stets korrekte, aktuelle Treffer angezeigt
  • Es fühlt sich großartig an, ein Problem, das lange Zeit störte, selbst beheben zu können
  • Wie George Hotz, der bei Twitter kurz eingestiegen war, um ein Login-Popup zu fixen, halte ich eine hackerhaft-unternehmerische Haltung beim direkten Lösen von Problemen für sinnvoll
  • Solche direkten und greifbaren Problemlösungserfahrungen bringen meine Karriere in eine bessere Richtung

Der praktische Wert von Open Source

  • Persönlich bevorzuge ich die Entwicklung und Nutzung von Open Source Software
  • In Open Source kann ein externer Entwickler Bugfixes oder Feature-Verbesserungen über einen Pull Request (PR) einreichen
  • Wäre Mintlifies Suchfunktion Open Source gewesen, hätte sich das Problem, das über ein Jahr lief, sofort per PR lösen lassen
  • Bei einem Closed-Source-Modell hängt jede Verbesserung davon ab, dass man Zugriff auf den Code hat, was eine klare Grenze darstellt
  • Ich erkenne den Wert der „sofortigen Berechtigung“ in Open Source an, verstehe aber auch die Unterschiede in den Geschäftsmodellen der einzelnen Unternehmen

Die Befriedigung durch direkte Verbesserungen

  • Der Grund, warum Mintlifies Suchfunktion runder und reaktionsschneller geworden ist, ist genau diese Änderung
  • Indem ich einen kleinen, lange ungelösten Bug selbst behoben habe, habe ich die Befriedigung empfunden, etwas zum Produkt beizutragen
  • Durch diese Erfahrung habe ich erneut gespürt, dass der fortwährende Fix auch kleiner Probleme ein Produkt deutlich verbessert
  • Kleine, selbst vorgenommene Veränderungen summieren sich zu einer sprunghaft besseren Nutzererfahrung
  • Ich möchte durch diese Akkumulation kleiner Verbesserungen weiterhin bessere Produkte bauen

Verwandte Beiträge

3 Kommentare

 
yangeok 2025-08-05

Hahaha, ich habe großen Respekt.
 
kimjoin2 2025-08-04

Top-Entwickler
 
GN⁺ 2025-08-03
Hacker-News-Kommentare

  • Mein Amazon-Konto wurde einmal wegen Betrugsverdachts gesperrt. Es war ein sehr altes Konto, und E-Mail-Adresse sowie Telefonnummer waren nach mehreren Datenbank-Leaks gelöscht worden. Nachdem ich eingestellt worden war, kontaktierte ich intern die zuständige Person im Amazon-Anti-Betrugsteam und konnte die Entsperrung meines Kontos schnell lösen. Über den Kundensupport zu gehen, hatte überhaupt nichts gebracht.

    • Das ist einer der nervigsten Aspekte an Amazon. Wenn ich auf Reddit oder in anderen Reviews ein Produkt finde, lande ich meistens über einen amazon.com-Link dort. Dann soll ich auf ein US-Dollar-Konto wechseln, und wenn ich bestellen will, muss ich wieder zurück auf mein deutsches/Euro-Konto wechseln. Dieser Ablauf ist viel zu umständlich. Es wäre schön, wenn man die Inhalte regional einfach frei ansehen könnte. Vielleicht sollte man das Profil erst beim Bestellen umstellen müssen. Eine Option, stattdessen bei einem Verkäufer in der eigenen Region zu kaufen, wäre auch gut.

    • Interessant. Ich habe immer noch das kaputte Handy aus meinem Google-Onboarding. Intern hat sich niemand darum gekümmert. Es gab zwar ein Tool, mit dem man es selbst hätte reparieren können, aber daran hing auch die Warnung, dass man entlassen würde, wenn man es ohne Erlaubnis benutzt.

    • Ich hatte auch einmal die Erfahrung, dass mein Facebook-Konto neun Monate lang nicht entsperrt wurde und dann sofort freigeschaltet wurde, als ich zufällig intern an etwas arbeitete.

    • Ich möchte in meinem Leben auch einmal so einen epischen Moment erleben.

    • Ich wünschte, ich hätte auch so ein Glück. Ich habe mein Amazon-Konto verloren, weil bei meiner internationalen Telefonnummer die erste Ziffer falsch eingetragen war. Dadurch konnte ich keine SMS-Verifizierung nutzen, und das Handy mit der OTP-App war kurz davor ebenfalls kaputtgegangen.

  • Wenn Google Maps mich einstellen würde, damit Entfernungen nur noch in km angezeigt werden, dann stehen meine Kontaktdaten in meinem HN-Profil. Ich glaube, ich habe in 20 Jahren bestimmt 500-mal von Meilen auf km umgestellt. Dass ein Unternehmen, das Nutzer analysiert, so etwas Grundlegendes nicht hinbekommt, ist absurd.

    • 500-mal ist wirklich absurd. Ich stelle mir schon vor, wie das in einem A/B-Test wegen zu geringer Nutzerbeteiligung scheitert. Fühlt sich an, als hätte man sieben Bewerbungsgespräche geführt und einen PR eingereicht, nur damit es so endet.

    • Ich würde gerne die Person finden und ohrfeigen, die dafür verantwortlich ist, dass die gesamte Karte für die ganze Fahrt in einen „echte Größe 1 cm = 1 cm“-Modus hineinzoomt. Wahrscheinlich ist das dieselbe Person, die zugelassen hat, dass das Auto beim manuellen Zoomen vom Bildschirm verschwindet, und beim Klick auf „neu zentrieren“ wieder zwangsweise auf den ursprünglichen Zoom zurückspringt. Schon Navis aus dem Jahr 2005 hatten so etwas gelöst.

    • Ich habe mich auf einer Reise in Mexiko eingeloggt, und trotzdem hat Google Flights bei jedem neu geöffneten Tab wieder von Dollar auf Pesos umgestellt. Scheint ihnen wirklich egal zu sein.

    • Als ich vor zehn Jahren bei Google gearbeitet habe, habe ich dieses Problem über ein internes Feedback-Formular gemeldet und nie eine Antwort bekommen. Seitdem habe ich diesen Bug jedes Jahr über das Google-Maps-Feedback gemeldet, in manchen Jahren sogar zweimal. Inzwischen ist das wirklich ein peinlicher Bug.

    • Ich hätte auch Interesse, an gmaps zu arbeiten. Bei Fahrten von mehr als einer Stunde sollte bitte auch der Rückweg im Voraus gecacht werden. Es ist oft mühsam, sich den Weg merken zu müssen, wenn man keinen Empfang hat.

  • Es ist lustig zu sehen, wie ein alter Witz tatsächlich Realität wird. Es gibt die Bitte, (wieder) einen linken Rand hinzuzufügen. Text ganz am Bildschirmrand liest sich etwas unangenehm.

    • Als ich dem Link aus dem Beitrag gefolgt bin, habe ich einen Fall gesehen, in dem jemand bei Apple die automatische Löschung abgelaufener Pässe eingeführt hat und direkt danach wieder gegangen ist. Jetzt denke ich, dass ich innerlich jedes Mal Danke sagen sollte, wenn ich diese Funktion nutze. Das war wirklich ein extrem nerviges Problem.

    • Scherzhaft die Idee, ob es nicht besser wäre, direkt von OP angestellt zu werden und es zu reparieren.

    • Ich mag Websites nicht besonders, die Bildschirmfläche verschwenden.

    • Ich mag linksbündigen Text, ich finde, dort gehört Text einfach hin.

  • Es wird erklärt, dass der debounced search function ein AbortController hinzugefügt wurde, damit frühere Abfragen abgebrochen werden, sobald der Nutzer eine neue Eingabe macht. Das Nervigste ist, wenn Filter oder Suche schon greifen, obwohl man noch gar nicht fertig getippt hat. Sie sollten warten, bis die Eingabe vollständig abgeschlossen ist.

    • Bei der Grafana-Logsuche wird derzeit pro Abfrage abgerechnet, sobald man den aktuell angewendeten Log-Filter ändert, also bei jedem geänderten Zeichen. Aus genau diesem Grund musste ich meine UX-Gewohnheiten anpassen. Abgerechnet wird nicht für den gesamten gesuchten String, sondern effektiv pro Zeichen.

    • Als ich auf meinem Blog Live-Suche implementiert habe, ließ ich zuerst alle vorherigen Suchvorschläge fertig werden und schickte dann erst die neue Anfrage. Ich halte das für einen vernünftigen Mittelweg, um Serverlast zu vermeiden und zugleich die Reaktionsfähigkeit zu erhalten.

    • Ich hasse das besonders bei Buchungsseiten. Die Filter stehen in einer linken Seitenleiste, aber wenn nicht alles auf den Bildschirm passt, scrollt es bei jeder Änderung wieder nach oben, lädt neu, und die Filter werden schreibgeschützt, sodass man warten muss, bis alles fertig ist, bevor man endlich den nächsten hinzufügen kann.

    • Ein guter Kompromiss ist meiner Meinung nach, nach dem letzten Tastendruck ein paar hundert Millisekunden zu warten und dann die Abfrage zu senden. Oder man schickt die Abfrage zwar schon ab, zeigt die Ergebnisse aber erst an, wenn die Eingabe pausiert.

    • Ich hasse dieses Verhalten wirklich. Es ist, als würde in einem fancy Code-Editor bei jedem getippten Buchstaben ein Warnton losgehen. Wenn man i und f tippt und sofort die Meldung kommt: „Der if-then-Block wurde nicht geschlossen!“, dann ist das völlig überempfindlich, obwohl doch klar ist, dass man noch tippt. Besser wäre eine Meldung erst dann, wenn man wirklich fertig ist. In den meisten Sprachen oder Tools deaktiviere ich solche Echtzeitwarnungen und lasse mir Fehler erst beim Build oder beim Ausführen anzeigen. LSP (Language Server Protocol) sollte sich wirklich beruhigen.

  • Inzwischen ist Softwarequalität so schlecht, dass es einfacher erscheint, sich anstellen zu lassen und den Bug selbst zu beheben, wenn einen etwas nervt. Das erinnert mich an die Geschichte des Programmierers, der das Ladeproblem von GTA 5 behoben hat. Selbst bei einem so umsatzstarken Spiel wie GTA 5 war eine Qualitätsverbesserung also nicht einfach.

    • Ich sehe das nicht als Qualitätsproblem, sondern als Priorisierungsproblem. Unternehmen entscheiden sich zuerst für das, was das Team machen will, nicht für das, was Nutzer wollen. Es fehlt an echten Nutzertests und Datenexperimenten. Dieser Fall ist in Wirklichkeit weniger eine Lösung eines Problems als vielmehr ein Symptom des eigentlichen Problems. Vermutlich gibt es viel nützlichere Themen, aber hier hat eben eine Person die Funktion eingebaut, die sie selbst haben wollte.

    • Den Leuten, die bei GTA:O viel Geld für Karten ausgaben, war die Ladezeit egal. Ich war so genervt, dass ich angefangen habe, die Zeit zu stoppen, und festgestellt habe, dass ich länger auf Ladebildschirme als in echten Missionen geschaut habe. Danach habe ich das Spiel ganz aufgegeben.

  • Ein Scherz darüber, ob du vielleicht genau die Person aus dem Internet-Meme bist.

  • Im Artikel selbst wird der Teil mit der Einstellung überhaupt nicht erwähnt, und das macht mich neugierig. Es wirkt eher wie: „Etwas hat mich gestört, und weil ich bei der Firma gelandet bin, habe ich es repariert.“ Dadurch fühlt es sich an, als würde der Kern der Geschichte fehlen.

    • Ich vermute, die Firma des Autors wurde von seinem jetzigen Arbeitgeber übernommen, also wohl ein acquihire.

  • Umgekehrt habe ich früher einmal in einer Firma gearbeitet, in der es wegen IP-Anwälten unmöglich war, PRs für Open-Source-Code einzureichen. Wenn man aber exakte Eingabewerte und die Zeilennummer des Bugs sehr detailliert beschrieben hat, konnte man oft jemanden überzeugen, es selbst zu reparieren. Es fühlte sich ein bisschen so an, als hätte man statt Code kostenlose QA-Berichte geliefert.

  • Das erinnert mich an den legendären Vorfall, als George Hotz 2022 kurz bei Twitter einstieg und das Problem mit dem Login-Popup löste. Allerdings erinnere ich mich anders daran: George Hotz behauptete, er könne „die Suche reparieren“, war dann aber fast sofort wieder weg und entfernte am Ende als Trostpreis nur das Popup.

    • Diesmal bin ich kurz darin versunken, George Hotz, Patenttrolle und comma.ai noch einmal zu recherchieren. George Hotz’ Comma.AI kann mit dem comma 3x-Smartphone für 999 US-Dollar, einem OBD-II-Anschluss und einem Kabelbaum für 99 US-Dollar bei den meisten in den letzten zehn Jahren gebauten Autos — sogar bei Tesla — Funktionen auf Autopilot-Niveau hinzufügen. Gesamtkosten: 1098 US-Dollar. Das Ganze ist Open Source und auf GitHub verfügbar, und es unterstützt sogar ssh-Zugriff auf das Fahrzeug. Das optionale Cloud-Abo kostet 10 US-Dollar/Monat (eigene SIM) oder 24 US-Dollar/Monat (inklusive Mobilfunkdaten des Anbieters). Eine Funktion entsprechend Tesla Sentry Mode gibt es allerdings noch nicht; sie ist als Issue #29912 offen. Der ursprüngliche Tesla Sentry Mode verbraucht 250 W — bei einer 80-kWh-Batterie fällt der Ladestand damit in sieben Tagen von 80 % auf 30 %. Wenn openpilot unter 5 W bleiben würde, wäre das deutlich effizienter.

    • Ich erinnere mich daran, dass George Hotz groß verkündet hat, bei Twitter eingestiegen zu sein, dann nichts gemacht hat und still wieder gegangen ist. Ich fand das peinlich und selbst verschuldet.

    • Es wird erzählt, dass der Beitrag präziser korrigiert wurde und gleichzeitig der Blog selbst wegen eines Github-Pages-Bugs offline genommen wurde.

    • Ich erinnere mich, dass er Elon am Ende vorgeschlagen hat, Twitter komplett neu zu bauen.

  • Ich habe mich persönlich schon bei Discord beworben, nur um einen PR für eine Umschaltoption bei großen Emojis einreichen zu können. Nicht nur ich, sondern ganze Server wünschen sich das dringend.

    • Keine Ahnung, ob es hilft, aber ich umgehe das für mich vorläufig, indem ich nach dem Emoji einen Punkt setze. Für neue Nutzer bringt das nichts, aber für mich ist es ein Workaround.

    • Discord ist eine Electron-App, daher müsste sich das theoretisch per clientseitigem Mod umsetzen lassen. Das Risiko einer Kontosperrung kann ich aber nicht einschätzen.

    • Es gibt auch einen Kommentar, der nachfragt, was genau gemeint ist, und erklärt, dass es zum Beispiel bereits eine Option gibt, die automatische Umwandlung von Emoticons wie :) zu deaktivieren.