Alternativa a GitBook per la documentazione SaaS

Trupeer AI è l'alternativa a GitBook per i team di documentazione SaaS che necessitano di video tutorial e articoli scritti corrispondenti abbinati insieme, non solo testo su un sito wiki ospitato. Per definire chiaramente le aspettative: GitBook è eccellente per ospitare la documentazione SaaS tradizionale (dominio personalizzato, editor a blocchi, struttura wiki con pagine nidificate, generazione automatica di riferimenti OpenAPI, ricerca full-text). Trupeer non sostituisce nulla di tutto ciò. Trupeer sostituisce un livello diverso: la produzione di video tutorial e guide scritte corrispondenti che i clienti utilizzano effettivamente per apprendere il funzionamento del prodotto. Un team di documentazione SaaS utilizza Trupeer per generare il contenuto dalle registrazioni dello schermo, quindi lo distribuisce tramite le Pagine Condivise di Trupeer o lo incorpora nel sito di documentazione GitBook (o Mintlify, o ReadMe) che già possiede. La lacuna nella maggior parte della documentazione SaaS è che i documenti di solo testo senza video tutorial perdono engagement nei confronti dei concorrenti che puntano prima sui video.

• Trupeer non è una piattaforma di hosting per la documentazione. GitBook (dominio personalizzato, struttura wiki, riferimenti OpenAPI) lo fa ancora meglio.

• Trupeer è il generatore di video tutorial e articoli scritti corrispondenti di cui la maggior parte dei documenti SaaS ha bisogno, ma che GitBook non può produrre.

• Una singola registrazione dello schermo produce sia un video tutorial in formato MP4 sia un articolo in PDF o Word pronto per il centro assistenza.

• Traduci i documenti SaaS in oltre 65 lingue per gli utenti internazionali, con voce fuori campo del video e articolo scritto nello stesso processo.

• Distribuisci tramite le Pagine Condivise (ospitate da Trupeer, incorporabili) o scarica i file MP4 e PDF e ospitali dove preferisci all'interno del tuo sito di documentazione.

Cosa produce Trupeer che GitBook non offre

Un team di documentazione SaaS apre Trupeer e avvia una registrazione dello schermo del flusso di prodotto che desidera documentare: il flusso di registrazione dell'utente, la configurazione dell'integrazione, la configurazione delle funzionalità, la generazione della chiave API. Trupeer AI si occupa della post-produzione. I intercalari vengono eliminati. Gli effetti di zoom e del cursore evidenziano gli elementi della UI che contano. Una bozza del video tutorial e una bozza dell'articolo scritto arrivano insieme nell'editor, entrambi estratti dalla stessa registrazione sorgente. L'articolo scritto presenta screenshot e passaggi numerati in linea. Il video tutorial include sottotitoli, effetti di zoom sui clic critici e slide di introduzione e conclusione personalizzate con il brand-kit.

Ciò che viene distribuito alla fine sono due risorse da un'unica registrazione: un video tutorial MP4 pronto per essere incorporato nel sito di documentazione GitBook, pubblicato su YouTube o ospitato sulla Pagina Condivisa di Trupeer; e un articolo scritto (PDF, Word, o incollato nella piattaforma di documentazione) con lo stesso contenuto del video. I documenti SaaS che dispongono di entrambi i formati vengono utilizzati in due modalità diverse: i clienti sul sito di documentazione leggono prima l'articolo e guardano il video quando si bloccano; i clienti nelle email di onboarding ricevono il link del video; i clienti nei ticket di supporto ricevono il link alla relativa Pagina Condivisa. GitBook è ottimo nella prima modalità e assente nella seconda; Trupeer è progettato per entrambe.

Come funziona questa alternativa a GitBook in tre passaggi

Tre passaggi coprono il flusso di produzione dalla registrazione dello schermo alle risorse incorporabili. Nessun editor video, nessun redattore separato, nessun passaggio di traduzione a parte.

Passaggio 1: Registra il flusso del prodotto

Premi registra nel browser e ripercorri il flusso del prodotto che il cliente deve apprendere. Casi d'uso di documentazione SaaS che funzionano bene: registrazione e onboarding, configurazione dell'integrazione, generazione e autenticazione delle chiavi API, configurazioni di funzionalità comuni, guide alla risoluzione dei problemi. Per i team SaaS che non desiderano registrare di persona, un avatar AI con uno script digitato offre lo stesso tutorial di un video con un presentatore reale, utile quando nessuno nel team vuole apparire davanti alla telecamera.

Passaggio 2: L'IA genera il video tutorial e l'articolo scritto

I intercalari e le pause vengono rimossi. Gli effetti di zoom e del cursore evidenziano dove l'utente deve fare clic o cosa deve leggere sullo schermo. Il brand kit applica il logo aziendale, i colori e le slide di introduzione e chiusura. Una bozza del video tutorial e una bozza dell'articolo scritto arrivano insieme nell'editor. Il glossario personalizzato riconosce i nomi delle funzionalità del prodotto, delle integrazioni e degli endpoint API che altrimenti l'IA non scriverebbe o trascriverebbe correttamente.

Passaggio 3: Incorpora nel sito di documentazione o distribuisci tramite Pagina Condivisa

Incorpora il video MP4 nella pagina di documentazione di GitBook (o Mintlify, ReadMe, Notion, Confluence, Document360, o ovunque risiedano effettivamente i documenti SaaS) utilizzando il codice di incorporamento video standard. Pubblica l'articolo scritto accanto ad esso nell'editor del sito di documentazione. Oppure salta del tutto il sito di documentazione e distribuisci tramite un link alla Pagina Condivisa di Trupeer, che unisce il lettore video, la trascrizione, l'articolo scritto e le opzioni di incorporamento in un unico URL personalizzato con il brand che il team può incollare nelle email di onboarding o nelle risposte di supporto. La traduzione in oltre 65 lingue si applica a entrambi i formati nello stesso processo.

Chi usa Trupeer insieme (o al posto di) GitBook

La persona che giunge su questa pagina è solitamente un responsabile della documentazione SaaS, un developer relations manager, un product marketing manager o uno specialista dell'apprendimento clienti che sta valutando GitBook come piattaforma di documentazione SaaS per rifare i documenti, rendendosi conto che il team ha bisogno anche di video tutorial che GitBook non è in grado di produrre. Hanno preso in considerazione le alternative a GitBook nella categoria di hosting della documentazione: Mintlify (moderno, incentrato sugli sviluppatori, forte OpenAPI), ReadMe (incentrato sulla documentazione API), Docusaurus (open source, creato da Meta), Document360 (base di conoscenza con flussi di lavoro), Notion (scopo generale, usato come strumento di documentazione SaaS da alcuni team), Confluence (wiki aziendale). Ognuno di questi gestisce il problema dell'hosting e dell'editor. Nessuno di essi genera i video tutorial o gli articoli scritti corrispondenti da una registrazione dello schermo, ed è proprio questo il vuoto colmato da Trupeer come categoria diversa di software di documentazione SaaS.

Il modello che funziona davvero per la maggior parte dei team di documentazione SaaS: utilizzare GitBook (o Mintlify, o ReadMe) per il sito della documentazione stesso, con i riferimenti API, le panoramiche concettuali, gli articoli di risoluzione dei problemi e la struttura generale. Utilizzare Trupeer per i video tutorial di ciascun articolo e gli articoli scritti corrispondenti generati automaticamente quando viene rilasciata una nuova funzionalità, cambia un'integrazione o il team si rende conto che il documento di solo testo esistente non è sufficiente. I due strumenti si combinano in un'esperienza di documentazione che offre sia il contenuto testuale ospitato e ricercabile (punto di forza di GitBook) sia il contenuto visivo del tutorial (punto di forza di Trupeer). I team che cercano di utilizzare solo uno di questi si ritrovano costantemente a sentire la mancanza dell'altra metà.

Quale documentazione SaaS gestisce al meglio Trupeer

I tipi di documentazione SaaS che beneficiano maggiormente di un abbinamento video più articolo scritto: contenuti di onboarding e tour del prodotto (primi 15 minuti all'interno dell'app), tutorial specifici per le funzionalità (come impostare un webhook, come invitare un membro del team, come configurare il single sign-on), guide di configurazione dell'integrazione (come connettere Slack, come autenticarsi con l'API, come impostare l'esportazione dei dati), guide alla risoluzione dei problemi (cosa fare quando si verifica un errore X) e annunci di aggiornamento delle funzionalità (cosa è cambiato nell'ultima versione). Trupeer AI gestisce tutti questi casi a partire dallo stesso flusso di lavoro che va dalla registrazione al documento.

In generale, la documentazione di prodotto SaaS che trae vantaggio dal mostrare il prodotto reale in esecuzione trae vantaggio da Trupeer. La documentazione SaaS che riguarda concetti, principi di progettazione, glossari, FAQ o riferimenti API che non mostrano un flusso di interfaccia utente è preferibile che rimanga come testo in GitBook o in qualsiasi altra piattaforma di documentazione utilizzata dal team. La reale proposta di valore: Trupeer aggiunge lo strato di video tutorial a qualsiasi piattaforma di documentazione SaaS che il team già possiede. Il team ottiene l'hosting della documentazione da GitBook (o dalle sue alternative) e la produzione del tutorial da Trupeer, invece di dover scegliere tra l'uno o l'altro perdendo comunque delle funzionalità. Considerare Trupeer come uno strumento di documentazione che produce contenuti, abbinato a una piattaforma di documentazione che ospita contenuti, offre alla maggior parte delle librerie di documentazione di prodotti SaaS il meglio di entrambi i mondi.

Collocazione di Trupeer rispetto a GitBook e al resto del mercato delle piattaforme di documentazione

Trupeer non sostituisce il livello di hosting di GitBook. GitBook possiede ancora il sito di documentazione sul dominio personalizzato, la struttura wiki con pagine nidificate, l'editor collaborativo basato su blocchi, il controllo di versione sulle singole pagine, i permessi pubblici e privati, la ricerca full-text e la generazione automatica dei riferimenti OpenAPI. Trupeer non cerca di competere su nessuna di queste funzionalità. I team che cercano nel mercato delle alternative a GitBook un sostituto analogo per la piattaforma di documentazione (Mintlify, ReadMe, Docusaurus, Document360) dovrebbero scegliere da quell'elenco. I team che cercano un'alternativa a GitBook perché la loro reale carenza riguarda la mancanza di video tutorial e di documentazione tecnica in formato video sono capitati sulla pagina giusta.

Trupeer non sostituisce nemmeno il livello di riferimento API. Mintlify, ReadMe, Stoplight e Postman creano documentazione di riferimento API interattiva a partire da specifiche OpenAPI con console di prova immediata, campioni di codice in più lingue e test di autenticazione. Trupeer gestisce la guida guidata da un essere umano su come integrarsi con un'API (il flusso concettuale, la configurazione tipica, i punti critici) ma non il riferimento endpoint per endpoint. La maggior parte dei team SaaS abbina entrambi: documenti di riferimento API in Mintlify o ReadMe, video tutorial di integrazione e articoli scritti corrispondenti in Trupeer.

Ciò che Trupeer sostituisce, più velocemente e a un costo di produzione inferiore rispetto alle alternative, è il lavoro manuale di produzione dei contenuti dei tutorial. Editor video, scrittori tecnici e specialisti di documentazione freelance svolgono tutti questo lavoro oggi; il team che acquista Trupeer riduce il costo per singola risorsa da diverse centinaia di dollari (tempo dello scrittore più tempo dell'editor) a meno di $50 per risorsa (tempo di registrazione dell'esperto in materia più elaborazione dell'IA). Su una libreria di documentazione SaaS con oltre 100 articoli, il risparmio di manodopera si accumula notevolmente.

Traduzione e aggiornamenti per utenti SaaS globali

La maggior parte dei prodotti SaaS opera con utenti internazionali fin dal primo giorno. I documenti distribuiti in inglese funzionano per la metà degli utenti che legge l'inglese e registrano scarse prestazioni per tutti gli altri. La traduzione in GitBook (e nella maggior parte delle piattaforme di documentazione) richiede riscritture manuali o servizi di traduzione esterni, entrambi così costosi che la maggior parte dei team di documentazione SaaS rinuncia del tutto alla traduzione. Trupeer traduce sia la voce fuori campo del video sia l'articolo scritto corrispondente nello stesso processo, in spagnolo, portoghese, hindi, mandarino, francese, tedesco, giapponese, arabo o in una qualsiasi delle oltre 65 lingue parlate dagli utenti. La clonazione vocale mantiene la voce del presentatore originale nelle versioni tradotte, in modo che i documenti localizzati sembrino realizzati appositamente anziché semplicemente doppiati.

Gli aggiornamenti sono l'altro asse in cui i documenti SaaS invecchiano rapidamente. Una modifica della UI rende obsoleto il video tutorial del trimestre precedente, un aggiornamento delle funzionalità rende fuorviante l'articolo scritto esistente, una modifica dell'integrazione compromette l'intera guida alla configurazione. La maggior parte dei team di documentazione SaaS gestisce questo problema lasciando che i documenti diventino obsoleti e rispondendo alle stesse domande nei ticket di supporto ogni volta che un cliente si imbatte in un articolo non aggiornato. Trupeer gestisce gli aggiornamenti registrando nuovamente solo il passaggio modificato. L'IA rielabora solo quel segmento, aggiornando sul momento sia il video sia l'articolo scritto, e il cliente nel sito di documentazione (o nell'incorporamento all'interno di GitBook) visualizza automaticamente la versione aggiornata. L'abbinamento di questo flusso di lavoro con il creatore di SOP Trupeer AI copre sia la documentazione SaaS rivolta ai clienti sia le procedure operative standard interne collocate al suo fianco.