Eine übersehene Funktion
Jahrelang war mein Workflow zum Nachschlagen von Dokumentation in Xcode derselbe: Cmd-Klick auf ein Symbol, „Show Quick Help” aus dem Kontextmenü wählen, das Popup lesen, dann schließen und weitercodieren. Es funktioniert, aber es unterbricht – jede Suche erfordert drei Aktionen und bricht deinen Arbeitsfluss.
Dann habe ich zufällig das Quick Help Inspector-Panel in der rechten Sidebar entdeckt.
So funktioniert es
Öffne den Quick Help Inspector mit Option+Cmd+3 oder gehe zu View > Inspectors > Quick Help. Das öffnet ein Panel in der rechten Sidebar, das Dokumentation für das Symbol anzeigt, auf dem sich dein Cursor gerade befindet. Wenn du deinen Cursor durch den Code bewegst – auf eine Methode klickst, durch Parameter navigierst, einen Typ auswählst – aktualisiert sich die Sidebar automatisch.
Kein Klicken, kein Popup zum Schließen, keine Unterbrechung. Du codierst einfach weiter und die relevante Dokumentation folgt dir.
Warum es Cmd-Klick übertrifft
Der Cmd-Klick-Ansatz hat einen bestimmten Nachteil: Er erfordert, dass du entscheidest „Ich brauche Docs dafür”, bevor du nachschaust. Die Sidebar kehrt das um. Weil sie immer sichtbar ist, nimmst du Dokumentation passiv auf. Du bemerkst Parameterbeschreibungen, Rückgabetypen, Deprecation-Warnungen und Verfügbarkeitsannotationen, ohne bewusst danach suchen zu müssen.
Das ist besonders wertvoll beim Arbeiten mit unbekannten APIs. Anstatt bei jedem zweiten Symbol Cmd zu klicken, bewegst du einfach deinen Cursor durch den Code und liest die Sidebar nebenbei. Es verwandelt das Nachschlagen von Dokumentation von einer einzelnen Aktion in einen kontinuierlichen Strom.
Das Panel zeigt denselben Inhalt wie das Quick Help-Popup: Deklaration, Beschreibung, Parameter, Rückgabewert, Verfügbarkeit und verwandte Symbole. Der einzige Unterschied ist, dass es bestehen bleibt und sich an Ort und Stelle aktualisiert, anstatt zu erscheinen und zu verschwinden.
Wenn du den Platz für die rechte Sidebar hast, ist das Offenhalten von Quick Help beim Codieren eine dieser kleinen Workflow-Änderungen, die sich über die Zeit summieren.