Schreiben Sie einen Wissensdatenbankartikel neu, ohne seine Anweisungen zu verlieren

Richten Sie den Artikel auf eine Zielgruppe und eine Aufgabe aus

Ein Artikel zu Benachrichtigungseinstellungen vermischt möglicherweise Kontoeinrichtung, Berechtigungen und Fehlerbehebung. Legen Sie vor der Überarbeitung fest, wo der Leser startet und welches Ergebnis er erreichen soll. Verschieben Sie alles Weitere in Voraussetzungen, verwandte Links oder einen eigenen Artikel. Diese redaktionelle Entscheidung ist oft wichtiger als eine Änderung des Tons.

Erstellen Sie eine Aufgabenkarte mit Artikel-ID, Zielgruppe, unterstützter Produktversion, erforderlicher Rolle, genauen Oberflächenbezeichnungen, erwartetem Ergebnis, bekannten Ausnahmen und verantwortlicher Person. Verwenden Sie nur freigegebenes Material. Kennzeichnen Sie unklare Schritte zur Prüfung, statt ein Modell die Lücke aus dem Gedächtnis füllen zu lassen. Googles Verfahrensleitfaden empfiehlt handlungsorientierte Schritte und genügend Kontext, um die Aktion zu finden.

Eine fiktive Neufassung mit festen Produktfakten

Stellen Sie sich ein fiktives Arbeitswerkzeug vor. Mitglieder können persönliche E-Mail-Benachrichtigungen unter Settings → Notifications deaktivieren. Nur ein Workspace-Inhaber darf organisationsweite Standardeinstellungen ändern. Die Änderung betrifft künftige E-Mails, entfernt aber keine bereits eingereihten Nachrichten. Das sind erfundene Beispieldaten, keine Colay-Funktionen.

Fragen Sie nach unterschiedlichen Strukturen unter Verwendung derselben Fakten. Eine Prozedur hilft jemandem, die Aufgabe sofort zu erledigen; Eine Fehlerbehebungsversion hilft jemandem, der das Steuerelement nicht finden kann. Eine FAQ kann die Ausnahme für E-Mails in der Warteschlange erklären. Acht gewünschte Ansätze sind möglich, sie sollten jedoch acht Lesesituationen berücksichtigen, anstatt dieselben Sätze zu multiplizieren.

Ein Prompt, der Formulierungen von Produktfakten trennt

Mit Ask separately in Colay sehen Sie, wie ausgewählte Agenten die Aufgabe verstehen. Vergleichen Sie zuerst die Gliederungen, bevor Sie ganze Artikel verfeinern. Entfernt eine Antwort die erforderliche Berechtigung, während andere sie beibehalten, prüfen Sie die freigegebene Quelle. Einigkeit ersetzt keinen Test des dokumentierten Ablaufs.

Schreiben Sie diesen genehmigten Wissensdatenbankartikel neu: [Text]. Aufgabenkarte: [Zielgruppe, Produktversion, Rolle, genaue UI-Beschriftungen, erwartetes Ergebnis, Ausnahmen]. Erstellen Sie eine nummerierte Anleitung, eine Version zur Fehlerbehebung und eine kurze FAQ-Version. Behalten Sie alle Bedingungen, Erlaubnisse und Ausnahmen bei. Erfinden Sie keine Kontrollen oder Verhaltensweisen. Listen Sie für jede Version den Quellsatz auf, der jede Anweisung unterstützt. Fügen Sie unklares oder widersprüchliches Quellenmaterial in eine separate Fragenliste ein. Empfehlen Sie eine Struktur für [Lesersituation] und erläutern Sie die Wahl. Kombinieren Sie nicht stillschweigend Fakten aus verschiedenen Produktversionen.

Verwandeln Sie den besten Entwurf in eine veröffentlichungsfähige Überarbeitung

Das endgültige Artefakt kann klein sein: genehmigter Titel, Voraussetzungen, Verfahren, erwartetes Ergebnis, Ausnahmen und ein relevanter nächster Link. Behalten Sie die Quelle-Anweisungs-Zuordnung mit den redaktionellen Notizen bei. Colay hilft beim Entwurf und Vergleich; Dieser Workflow bedeutet nicht, dass er eine Verbindung zu Ihrer Wissensdatenbank herstellen oder Änderungen automatisch veröffentlichen kann.

1. Wählen Sie die Struktur, die zur Aufgabenkarte passt. Behalten Sie nützliche Sätze aus anderen Entwürfen erst bei, nachdem Sie deren Bedeutung überprüft haben.
2. Gehen Sie alle Schritte mit der angegebenen Rolle in der unterstützten Produktversion durch. Prüfen Sie Bezeichnungen, Reihenfolge, Ergebnis und die dokumentierte Ausnahme.
3. Lesen Sie den Artikel als neuer Benutzer: Voraussetzungen sollten angezeigt werden, bevor sie benötigt werden, und für einen fehlgeschlagenen Schritt sollte eine nächste Aktion verfügbar sein.
4. Erfassen Sie den Rezensenten, die Artikelversion und die geänderten Abschnitte. Veröffentlichen Sie über Ihren bestehenden Wissensdatenbank-Workflow und behalten Sie die vorherige Version zum Vergleich bei.

Beurteilen Sie die Umschreibung danach, was ein Leser tun kann

Bitten Sie einen mit dem Entwurf nicht vertrauten Kollegen, den Ausgangspunkt zu finden, die benötigten Rechte zu benennen und das Ergebnis des letzten Schritts zu erklären. Halten Sie Missverständnisse als redaktionelle Aufgaben fest. Liegen Feedback oder Suchdaten zum Artikel vor, vergleichen Sie dieselben Signale nach der Veröffentlichung, ohne jede Veränderung der KI zuzuschreiben. Beenden Sie die Generierung, sobald ein fehlender Produktfakt und nicht die Wortwahl die weitere Arbeit blockiert.

Antworten auf Ihre Fragen