Wie können wir in Flare atomare Änderungsgruppen überprüfen?

Mein Team verwendet MadCap Flare für die Dokumentation und wir haben einen Redakteur im Team. Wenn ein Autor bereit ist, stellen wir ein Bewertungspaket in Flare zusammen und senden es an den Redakteur, und sie nimmt Änderungen vor und sendet es zur Lösung an den Autor zurück. (Der Verfasser hat das letzte Wort und ist dafür verantwortlich sicherzustellen, dass Änderungen die technische Genauigkeit der Dokumentation nicht verändern.) Das an den Verfasser zurückgesendete Überprüfungspaket enthält markierte Änderungen, die denen im Modus „Änderungen nachverfolgen“ von Word ähneln – - Streichungen für Löschungen, eine andere Farbe für Einfügungen und Anmerkungen (Callouts) für andere Kommunikation zwischen Redakteur und Autor.

Das ist alles in Ordnung, aber Flare erfordert, dass jede Änderung einzeln akzeptiert oder abgelehnt wird, und das Problem, das wir haben, ist, dass eine Bearbeitung für einen einzelnen Absatz ein Dutzend einzelner Änderungen hervorrufen kann, von denen jede behandelt werden muss. Wenn Sie versehentlich 11 davon akzeptieren und eine ablehnen würden, hätten Sie einen durcheinandergebrachten Text, da die Änderungen alle miteinander zusammenhängen. Wir wollen atomare Veränderungsgruppen – akzeptiere alle oder keine davon – in dieser Situation. (Flare unterstützt „alle akzeptieren“ oder „alle ablehnen“ auf Dateiebene, aber das ist zu grobkörnig.)

Wir haben Google ausprobiert und wir haben einige ziemlich erfahrene Flare-Benutzer im Team, und das Beste, was uns eingefallen ist, wenn ein Textblock viele kleine Änderungen erfordert, ist, dass der Editor den Text ausschneidet und einfügt einen neuen Block, bearbeite diesen und lösche dann das Original. Aber das ist mühsam, wenn es die ganze Zeit gemacht wird, und schwer vorhersehbar, wenn Sie während der Bearbeitung Änderungen vornehmen. Der Redakteur sollte nicht zwei Durchgänge machen müssen, einen zum Lesen und dann einen zweiten, um zurückzugehen und Änderungen entweder "inline" (wenn nur wenige) oder durch diese aufwändigere Cut/Paste-Routine (wenn umfangreicher) vorzunehmen.

Gibt es eine Möglichkeit, Flare dazu zu bringen, einen ausgewählten Satz von Änderungen zu gruppieren, um die Atomarität zu unterstützen? Ich stelle mir vor, dass der Redakteur alle Änderungen in einem Absatz als Teil derselben Gruppe markieren kann und der Autor dann zu dieser Gruppe „ja“ oder „nein“ sagen kann.

Wir verwenden eine Mischung aus Version 9 und 10. Wenn ein Upgrade aller auf Version 10 helfen würde, können wir das tun.

Ich weiß nichts über Ihre spezifischen Probleme, aber vielleicht ist es an der Zeit, ein anderes Tool in Betracht zu ziehen. Nur um ein Beispiel zu nennen: Einige Leute verwenden Git, um Dokumente (außer Programmen) zu verwalten, und es ermöglicht alle Arten von Flexibilität für die Handhabung von Revisionen. Ich bin mir sicher, dass es auch andere Tools gibt. Es könnte auch möglich sein, mehr als ein Werkzeug zu kombinieren - machen Sie feine Körnung in Git und setzen Sie die Änderungen dann als eine Änderung wieder in Flare usw.
@Joe wir können die Werkzeuge nicht wechseln; Dies wird unternehmensweit verwendet und es gibt eine enorme installierte Basis. Wir verwenden auch die Quellcodeverwaltung, aber wir verwenden das Überprüfungssystem von Flare, weil der Überprüfer direkt im WYSIWYG-Editor arbeiten kann, ohne Änderungen am Quellbaum vorzunehmen, bis der Autor die Änderungen akzeptiert oder ablehnt (an diesem Punkt steuerungstechnisch wird es wie jede andere Bearbeitung behandelt). Das meiste davon funktioniert ziemlich gut, aber wir haben keine gute Lösung für dieses spezielle Problem gefunden. Danke für die Eingabe.
Version 11 ist draußen und enthält Git-Unterstützung. Ich würde ihnen eine E-Mail schreiben und fragen, was sie empfehlen, vielleicht sogar Atomarität als Feature anfordern, wenn es nicht vorhanden ist.

Antworten (1)

Das hat nichts mit der Quellcodeverwaltung zu tun, daher ist die GIT-Unterstützung in V11 und 12 ein Ablenkungsmanöver.

Besser geht das nicht, Stand Version 12 (April 2016). Was du tust und deine Arbeit herum sind die einzigen zwei Möglichkeiten, die ich kenne, um zu tun, was du willst.

In unserer Gruppe verwenden wir Änderungen nachverfolgen für die Änderungen, die der Autor überprüfen soll. Wir verwenden „Änderungen nachverfolgen“ nicht für die Änderungen, die wir vornehmen dürfen, ohne dass der ursprüngliche Autor sie erneut überprüft. Dies hat jedoch den unerwünschten Effekt, dass der Redakteur ständig auf die Ein/Aus-Schaltfläche klicken muss.

Ihre andere Option wäre, dem Überprüfer nur zu erlauben, das Dokument zu kommentieren, anstatt das Dokument zu bearbeiten, aber das hat andere schmerzhafte Auswirkungen.

Abschließend möchte ich darauf hinweisen, dass Flare in Flare 12 beim Generieren einer PDF-Datei jetzt die Option hat, den Inhalt der nachverfolgten Änderungen und die Kommentarblasen in der PDF-Datei zu drucken, sodass die Benutzer die PDF-Datei selbst überprüfen und die nachverfolgten Änderungen sehen können. Ich weiß, dass dies den Bedarf in Ihrer Frage immer noch nicht direkt beantwortet, aber es ist eine coole neue Funktion, die sich auf das bezieht, worüber wir sprechen.

Das Beste, was Sie an dieser Stelle tun können, ist, eine Feature-Anfrage auf der Website von MadCap einzureichen, in der Sie ein Beispiel und einen Anwendungsfall angeben. Sie sind ziemlich empfänglich für Feedback.

Vielen Dank. Ich denke, wir haben diese Feature-Anfrage (irgendwann im Jahr 2014) eingereicht, aber vielleicht ist es an der Zeit, sie noch einmal anzustoßen. Wir sind jetzt auf Flare 11, wobei eine Person 12 testet – schade zu hören, dass 12 uns dabei auch nicht helfen wird.