any2.video
Diese Seite wurde maschinell übersetzt und wird gerade von Muttersprachlern geprüft; maßgeblich ist die englische Fassung: English
~/alternatives / technical-writer

any2.video vs. einen technischen Redakteur einstellen: zwei Antworten auf dasselbe Abdeckungsproblem

Ein guter technischer Redakteur gehört zu den Einstellungen mit der größten Hebelwirkung, die ein Softwareunternehmen vornehmen kann, und nichts auf dieser Seite spricht dagegen, einen einzustellen. Schriftliche Dokumentation und verifiziertes Video beantworten unterschiedliche Hälften des Abdeckungsproblems, und die Wahl zwischen beiden ist eigentlich die Frage, welche Hälfte gerade nicht funktioniert.

Was jede Option beweist

FrageTechnischer Redakteurany2.video
Was dabei entstehtDurchsuchbarer, verlinkbarer, korrigierbarer Text.Eine Aufnahme der Aufgabe bis zum Abschluss, dazu eine schriftliche Anleitung.
Beantwortet „Wo ist die Schaltfläche?“In Worten, die der Leser dem Bildschirm zuordnen muss.Indem das Video sie zeigt.
Beantwortet „Warum gibt es das?“Sehr gut. Genau dafür ist Text da.Schlecht. Für Referenzmaterial taugt Video wenig.
Tempo der AbdeckungSchnell bei Text, langsam bei allem, was eine Bildschirmaufnahme braucht.Zwei Tage pro Aufgabe, in Paketen.
Wo man es findetIn Ihrer Dokumentation und in Suchmaschinen.Auf YouTube und bei KI-Assistenten, wo Produktfragen gestellt werden.
Aktuell bleibenHängt von Disziplin und Review-Prozess ab.Ein Versions-Tag plus ein erneuter Durchlauf bei jedem Release.

Wann ein technischer Redakteur die richtige Wahl ist

  • Ihre Dokumentation ist unvollständig, widersprüchlich oder vernachlässigt. Beheben Sie das zuerst. Video auf schlechter Dokumentation verbreitet den Fehler nur weiter.
  • Der Inhalt ist Referenzmaterial: Parameter, API-Schnittstellen, Grenzwerte, konzeptionelle Erklärungen.
  • Leser müssen suchen, kopieren und verlinken können. Niemand kopiert einen Befehl aus einem Video.
  • Sie brauchen die Inhalte im Release-Prozess und nicht daneben.

Wann nicht

  • Der schriftliche Schritt existiert, und Nutzer führen ihn trotzdem falsch aus, was meist bedeutet, dass der Bildschirm nicht so aussieht, wie der Satz ihn beschreibt.
  • Die Frage lautet „Funktioniert es tatsächlich?“, und die kann Text nicht klären, ein Nachweis auf dem Bildschirm aber schon.
  • Ihre Käufer bilden sich ihre Meinung auf YouTube, wo Ihre Dokumentation nicht vorkommt.
  • Der Redakteur, den Sie eingestellt haben, verbringt seine Woche mit Screenshots statt mit Schreiben.

Die richtige Reihenfolge

Zuerst die Dokumentation. Wenn die schriftliche Vorgehensweise falsch ist, ist ein Video davon eine überzeugendere falsche Vorgehensweise. Wir haben aus diesem Grund schon Aufträge abgelehnt und würden es wieder tun.

Sobald die Dokumentation stimmt, fehlt es nicht an Information, sondern an Beweis und Wiedererkennung. Ein Nutzer, der den Schritt gelesen hat und den Schalter trotzdem nicht findet, braucht den Satz nicht noch einmal. Er muss den Bildschirm sehen.

Jeder Walkthrough wird mit Text geliefert

Deshalb sind die schriftliche Anleitung und die Hinweise zur Fehlerbehebung im Preis enthalten, statt als Upsell verkauft zu werden. Jeder verifizierte Durchlauf liefert genau die Schritte, die funktioniert haben, der Reihe nach, mit den gescheiterten Versuchen und ihren Lösungen. Dieses Ergebnis ist oft besser als das, was in der Dokumentation stand, weil es aus einem Durchlauf stammt und nicht aus dem Gedächtnis, und Ihr Redakteur kann es direkt in die Dokumentation übernehmen.

Was ein Redakteur davon hat

Bildschirmaufnahmen sind die am wenigsten wertvolle Arbeit eines technischen Redakteurs, und sie fressen seine Woche auf. Ein verifizierter Durchlauf liefert ihm ein Protokoll mit Zeitstempeln darüber, was tatsächlich passiert ist, also das Rohmaterial, das er sonst von Hand rekonstruiert hätte.

Fragen

Sollten wir einen technischen Redakteur einstellen oder Video kaufen?

Wenn die Dokumentation falsch ist oder fehlt, stellen Sie zuerst den Redakteur ein. Video auf Basis ungenauer Dokumentation vervielfacht den Fehler. Wenn die Dokumentation solide ist und Nutzer trotzdem nicht weiterkommen, fehlt es an Beweis statt an Information, und genau das liefert ein verifizierter Walkthrough.

Ersetzt das Video unsere Dokumentation?

Nein, und das soll es auch nicht. Text ist durchsuchbar, kopierbar und günstig zu korrigieren. Video eignet sich schlecht für Referenzmaterial und gut dafür, zu zeigen, wie eine Aufgabe abgeschlossen wird.

Bekommen wir etwas, das unser Redakteur nutzen kann?

Ja. Jeder Walkthrough wird mit genau den Schritten geliefert, die funktioniert haben, und mit den gescheiterten Versuchen, erstellt aus dem Ausführungsprotokoll. Die meisten Teams übernehmen das direkt in ihre Dokumentation.

Am schnellsten klären Sie das mit einer Aufgabe, auf beide Arten umgesetzt. Das erste Probevideo ist kostenlos.

$ get-sample → $ cd /library