Beliebte Integrationen mit Fluid Topics zur Optimierung Ihres Content-Workflows

Hinweis: Dieser Blogartikel wurde aus seiner Originalversion übersetzt und kann geringfügige Abweichungen enthalten. Auch die im Text enthaltenen Zitate wurden übersetzt.

Viele Unternehmen haben mit Inhalten zu kämpfen, die über mehrere Silos verteilt sind. Dies erschwert die konsistente und zugängliche Bereitstellung von Informationen über alle Nutzer-Touchpoints hinweg. Bei Fluid Topics helfen wir unseren Kunden, Content-Silos mit sofort einsatzbereiten Konnektoren aufzubrechen, die es unserer Product Knowledge Platform (PKP) ermöglichen, Inhalte aus verschiedenen Quellen zu aggregieren und zu vereinheitlichen. Ob PDFs, Word-Dokumente, Markdown-Dateien oder strukturierte Inhalte aus einem CCMS – alle Informationen werden nahtlos in einem einzigen, zentralisierten Hub zusammengeführt. Sobald Fluid Topics die Dokumentation aggregiert hat, stellt es alle Inhalte einfach und sofort an jeden digitalen Kanal bereit, einschließlich unseres sofort einsatzbereiten, anpassbaren Dokumentationsportals.

Unsere Teams sind stets auf der Suche nach neuen Konnektormöglichkeiten und arbeiten eng mit unseren Kunden zusammen, um deren Anforderungen zu erfüllen. Lesen Sie weiter, um mehr über Fluid Topics Konnektoren zu erfahren, und entdecken Sie dann die wertvollsten Integrationen unserer Kunden.

Was sind Fluid Topics Konnektoren?

Es gibt zwei Arten von Konnektoren: solche für unsere Authoring-Tool-Partner und solche für spezifische Formate.

Für unsere Partnerlösungen arbeiten wir mit deren Teams zusammen, um nahtlose Publishing-Workflows zu erstellen. Diese Integrationen ermöglichen es Technical Writern, direkt aus ihrer Content-Erstellungsumgebung heraus mit nur einem Klick auf eine Schaltfläche in Fluid Topics zu veröffentlichen. Mit diesen UI-„Add-ons“ fungiert die Content-Quelle als Brücke zu Fluid Topics, vereinfacht den Publishing-Prozess und reduziert den manuellen Aufwand.

Für Format-Konnektoren können Content-Administratoren Dateien manuell direkt in das Fluid Topics Portal hochladen oder unsere APIs verwenden, um Inhalte aus bestimmten Quellen zu veröffentlichen. Beispielsweise kann ein Team, das in Markdown mit Visual Studio Code arbeitet, seine Inhalte bündeln und über unseren Markdown-Konnektor in Fluid Topics veröffentlichen. Die Konnektoren dienen als Eingangstor, verarbeiten und bereiten die Inhalte für die Bereitstellung innerhalb der Plattform vor.

Diese Konnektoren bieten echten geschäftlichen Mehrwert für Kunden. Die Dokumentation von Teradata wurde mit sechs verschiedenen Tools erstellt, was zu einer inkonsistenten und isolierten Content-Erfahrung für die Nutzer führte. Durch die Zentralisierung ihrer technischen Inhalte auf einem einzigen Dokumentationsportal, das von Fluid Topics betrieben wird, optimierten sie Zugang und Bereitstellung und verwandelten ihr Dokumentationsportal in die meistbesuchte Website des Unternehmens mit über 5 Millionen Besuchen in einem einzigen Jahr.

Fluid Topics ist ein enormer Fortschritt für uns. Das Content-Delivery-Portal hat sich zu einer Unternehmensressource entwickelt, die unsere internen Teams und unsere Kunden direkt unterstützt.

Elizabeth McFadden

Technical Project Manager für Content Operations bei Teradata

7 Integrationen, die unsere Kunden lieben 

Lesen Sie weiter und entdecken Sie 7 der beliebtesten Fluid Topics Konnektoren unserer Kunden, die unsere PKP mit den Content-Operations-Tools integrieren, die sie kennen und lieben.

1. Component Content Management Systeme

Obwohl das Ziel dieses Artikels darin bestand, weniger offensichtliche Integrationen hervorzuheben, können wir nicht über die Lieblingslösungen unserer Kunden zur Verbindung mit Fluid Topics sprechen, ohne mit Paligo, Author-it, Heretto und anderen beliebten Component Content Management Systemen (CCMSs) zu beginnen. Content-Erstellung und -Bereitstellung sind beide zentrale Bestandteile des Dokumentationsmanagements, daher sind CCMSs und Fluid Topics zusammen wesentliche Grundlagen für reibungslose Content-Operations.

CCMSs sind für die strukturierte Content-Erstellung konzipiert, bei der Technical Writer typischerweise in Markup-Sprachen wie DITA, DocBook oder S1000D arbeiten. Die dedizierten Lösungskonnektoren von Fluid Topics harmonisieren nahtlos Inhalte aus Ihrem CCMS zusammen mit jeder anderen Dokumentation (beispielsweise aus Word) auf Knopfdruck.

Beispielsweise hat der Anbieter von Human Resources Management Software, Darwinbox, unter Verwendung des Paligo-Konnektors seine Content-Produktion und -Bereitstellung überarbeitet.

Sie erstellen Inhalte, wie Sie möchten… und Fluid Topics ist in der Lage, sie wie von Zauberhand automatisch zu strukturieren und zu veröffentlichen. Für den Endnutzer ist es nahtlos, er würde nicht einmal merken, dass es von einer anderen Plattform stammt.

Sagar Garuda

Senior Director of Learning bei Darwinbox

Ebenso bedeutete für Hexagon die native Integration von Fluid Topics mit Author-it, dass ihr Dokumentationsteam technische Inhalte so oft wie erforderlich selbst veröffentlichen konnte, direkt aus der Author-it-Benutzeroberfläche und in einem vollständig automatisierten Prozess. Sie benötigten nach Abschluss der Integration keine zusätzliche IT-Arbeit oder Unterstützung mehr.

Wir haben bis zu zwei Wochen im Dokumentationsbereitstellungsprozess für große Produkte eingespart, was uns geholfen hat, unser Ziel von vierwöchigen Release-Zyklen zu erreichen.

Lonnye Yancey-Smith

Executive Manager bei Hexagon Asset Lifecycle Intelligence

2. Unstrukturierte Dokumente

Die meisten Office-, Design-, Präsentations- und E-Learning-Tools erzeugen unstrukturierte Dateien (d. h. .pdf, .rtf, .txt, .html, .ods, .odt, .odp, .xls, .ppt, .xmp). Dies ist keine Einschränkung für Fluid Topics. Um diese Lücke zu schließen, bieten wir einen Konnektor für unstrukturierte Dokumente an. Er ermöglicht es Teams, diese Rohdateien mit Metadaten und Struktur anzureichern und sie so für die nahtlose Veröffentlichung in ihrem Fluid Topics Portal bereitzumachen.

Microsoft Word

Word-Dokumente sind ein Paradebeispiel für unstrukturierte Inhalte. Selbst mit dem Aufkommen neuer Authoring-Tools bleibt Word ein bevorzugtes Werkzeug, insbesondere für Tech-Writing-Teams. Seine Kommentar- und Änderungsverfolgungsfunktionen halten es für das kollaborative Verfassen von Entwürfen führend.

Der Microsoft Word Konnektor von Fluid Topics verwandelt .docx-Dateien in strukturierte, themenbasierte Inhalte. Er zerlegt nicht nur Dokumente in wiederverwendbare Komponenten, sondern extrahiert auch eingebettete Metadaten und reichert Ihre Inhalte an, bevor sie in Ihrem Wissensrepository veröffentlicht werden.

3. OpenAPI

Die OpenAPI-Spezifikation ist zu einem globalen Standard für die Definition und Erstellung von RESTful APIs geworden. Entwickler weltweit verlassen sich darauf, um Open-Source-Tools und Frameworks zu betreiben. Mit Fluid Topics können Kunden ihre OpenAPI-Dokumentation einfach verbinden, indem sie sie in YAML- oder JSON-Formaten veröffentlichen und dann mit den dedizierten Format-Konnektoren in ihren Fluid Topics Content-Hub einbinden.

Als wir mit HPS, einem globalen Anbieter von Zahlungslösungen und Fluid Topics Kunden, sprachen, teilten sie mit, wie sie damit begannen, ihre DITA-Inhalte aus Componize mit Fluid Topics zu veröffentlichen, und dann schnell zu ihrer Entwicklerdokumentation übergingen. Pierre-Olivier Saint-Joanis, HPS Quality Manager, enthüllte ihren Masterplan: „[Wir] arbeiten parallel an einer Swagger- (jetzt OpenAPI-) Dokumentation für unsere JSON-APIs. Zunächst öffneten wir das Portal für unsere 300 internen Ingenieure. Der Erfolg war sofort spürbar, weil es so einfach wurde, die richtigen Informationen in einem großen Corpus zu finden. Das Feedback dieser Nutzer ist hervorragend.“

4. MkDocs

MkDocs ist ein einfacher und schneller Static-Site-Generator, bei dem Dokumentationsteams Quelldateien in Markdown vorbereiten, sie in einem Dokumentationsverzeichnis speichern und sie mit einer einzigen YAML-Konfigurationsdatei verwalten können. Diese Plattform ist eine beliebte, kostenlose Ressource für Teams, die einen Docs-as-Code-Workflow implementieren möchten. Kunden können ein MkDocs-Dokument problemlos mit Fluid Topics verbinden.

Darüber hinaus erreichen Unternehmen durch die Kombination ihrer Markdown-Dateien mit dynamischer Content-Bereitstellung eine effiziente Dokumentationsproduktion und kontinuierliche Integration. Sehen Sie sich unser Webinar „Tech Doc and Continuous Integration: Wielding the Markdown Secret Weapon“ an, um zu entdecken, wie Ihre bestehenden Markdown-Inhalte Ihre technische Dokumentation bereichern können.

Zum Webinar (auf Englisch)

5. GitHub and GitLab

GitLab und GitHub sind zwei beliebte Versionskontrollplattformen, die Teams bei der Zusammenarbeit und Verwaltung von Code-Änderungen unterstützen. Entwickler, die in GitHub arbeiten, verlassen sich oft auf GitHub Actions, eine leistungsstarke Funktion, die wichtige Teile des Software-Entwicklungslebenszyklus automatisiert, wie Code-Reviews, Branch-Management und Issue-Triage, alles integriert mit CI/CD-Pipelines. Diese Art von Content ist äußerst wertvoll.

Teams können unsere Markdown- und OpenAPI-Konnektoren nutzen, um GitHub- und GitLab-Inhalte zu erhalten. In Kombination mit unserem FT Publishing Tool können sie auch die Extraktion von Markdown-Content-Updates automatisieren.

6. Jira

Jira ist ein beliebtes Issue-Tracking-System, das viele Unternehmen zur Verfolgung von technischen Support-Problemen und Bugs oder zur Planung ihrer Roadmap und Entwicklung verwenden. Dieses System enthält eine enorme Fülle an Informationen, und mithilfe von APIs können sie Release Notes direkt aus Jira in ihr Fluid Topics Dokumentationsportal veröffentlichen.

Fluid Topics integriert sich mit Jira unter Verwendung von benutzerdefinierten Bots und dedizierten Textfeldern, die jede Aufgabe mit einer spezifischen Release-Version verknüpfen. Wenn Teams den Bot auslösen, um auf Jiras Release-Management-System zuzugreifen, extrahiert er alle Aufgaben, die mit der neuesten Produktversionsnummer gekennzeichnet sind. Der Bot sammelt, harmonisiert und ordnet alle Ticket-Informationen in eine voreingestellte Release-Note-Vorlage, bevor er die Notiz zur Korrekturlesung im internen Portal des Unternehmens veröffentlicht. Nach etwaigen Aktualisierungen kann der Bot-Besitzer die finale Release Note mit einem einzigen Klick an sein öffentliches Dokumentationsportal ausliefern.

Fabrice Lacroix, CEO von Fluid Topics, und Gaspard Bébié-Valérian, zertifizierter Technical Writer und funktionaler Berater, erkunden diese Dokumentationsautomatisierung im Webinar „Scaling Content Operations with Docs as Code and Robots“.

Zum Webinar (auf Englisch)

7. Confluence

Viele Unternehmen nutzen dieses webbasierte Unternehmens-Wiki täglich, um ihre interne Dokumentation zu hosten. Es ist eine Goldmine für Informationen rund um kollaborative Projekte, Produkte und Wissen aus verschiedenen Teams.

Mit unserem Confluence-Konnektor verwandeln unsere Kunden ihre Confluence-Spaces in strukturierte Dokumente und machen sie zentral zugänglich in ihren Fluid Topics Content-Repositories. Während dieser Transformation wird jeder Confluence-Space zu einem Dokument und jede Seite innerhalb eines Space zu einem Thema.

Diese nahtlose Tool-Integration war ein wichtiges Verkaufsargument für Darwinbox. Sagar Garuda erklärte, wie Konnektoren wie dieser seinem Team halfen, interaktive, personalisierte und skalierbare Content-Erfahrungen für ihre Nutzer zu entwickeln. „Durch die Verbindung von Paligo, Confluence und Fluid Topics haben wir die Content-Veröffentlichung beschleunigt, ohne Qualität oder Genauigkeit zu opfern.“ Durch die Standardisierung der Content-Struktur und -Präsentation machen unsere Konnektoren Content-Operations von Anfang bis Ende nahtlos.

Entwicklung benutzerdefinierter Konnektoren

Wir haben mehrere weitere Konnektoren, die nicht erwähnt wurden, aber Sie können alle Konnektoren hier finden. Über die bestehenden Konnektoren hinaus arbeiten wir eng mit unseren Kunden zusammen, um einen reibungslosen Content-Delivery-Prozess zu gewährleisten. Diese Partnerschaft umfasst die Bearbeitung einzigartiger, benutzerdefinierter Verbindungsanforderungen, die nicht nativ Teil des Konnektor-Pakets von Fluid Topics sind. Daher bieten wir APIs für benutzerdefinierte Integrationen mit externen Drittanbieter-Apps und eine Python-Bibliothek an, damit Kunden ihre eigenen benutzerdefinierten Konnektoren für spezifischere Content-Quellenanforderungen entwickeln können.

Fazit

Unsere Kunden wissen, dass die Zusammenarbeit mit Fluid Topics eine sichere Möglichkeit ist, ihre Inhalte aus verschiedenen Quellen zu verbinden, alle Formate zu harmonisieren und sie in einem einheitlichen Wissensrepository zu zentralisieren. Die Schaffung einer nahtlosen Content-Erfahrung bietet echten Mehrwert, indem sie internen und externen Nutzern hilft, Produktinformationen schnell und einfach zu finden, den Umsatz zu steigern, Support-Kosten zu reduzieren und die Teameffizienz zu optimieren.

Fluid Topics hat unsere Abläufe verbessert, indem es unsere Inhalte vereinheitlicht und unsere Veröffentlichung zentralisiert hat, sodass wir sofort über 1 Million Produkte auf 60 Websites und 25 Portalen kommunizieren können. Die eingesparte Zeit und die verbesserte Nutzererfahrung? Das ist echter Mehrwert.

Nelson Abbey

Principal Information Developer bei Johnson Controls International