Alternativa gratuita ao GitBook para documentação de SaaS

Trupeer AI é a alternativa ao GitBook para equipas de documentação de SaaS que precisam de walkthroughs em vídeo e de artigos escritos correspondentes, juntos — não apenas texto num site de wiki alojado. Para definir expectativas de forma clara: o GitBook é excelente para alojar documentação tradicional de SaaS (domínio personalizado, editor de blocos, estrutura de wiki com páginas aninhadas, referência OpenAPI com geração automática, pesquisa de texto completo). A Trupeer não substitui nada disso. A Trupeer substitui uma camada diferente: a produção de vídeos de walkthrough e de guias escritos correspondentes que os clientes realmente usam para aprender o produto. Uma equipa de documentação de SaaS usa a Trupeer para gerar o conteúdo a partir de gravações do ecrã e, depois, ou o envia através das Shared Pages da Trupeer ou o incorpora no site de documentação do GitBook (ou Mintlify, ou ReadMe) que já tem. A lacuna na maioria da documentação de SaaS é que as páginas apenas com texto, sem walkthroughs em vídeo, estão a perder envolvimento face a concorrentes com estratégia “video-first”.

• A Trupeer não é uma plataforma de alojamento de documentação. O GitBook (domínio personalizado, estrutura de wiki, referência OpenAPI) continua a fazê-lo melhor.

• A Trupeer é o gerador dos vídeos de walkthrough e dos artigos escritos correspondentes de que a maioria das documentações de SaaS precisa, mas que o GitBook não consegue produzir.

• Uma única gravação do ecrã gera tanto um vídeo de walkthrough em MP4 como um artigo em PDF ou Word pronto para a central de ajuda.

• Traduza a documentação de SaaS para 65+ idiomas para utilizadores internacionais, com narração em vídeo e artigo escrito no mesmo trabalho.

• Envie através das Shared Pages (alojadas pela Trupeer, incorporáveis) ou descarregue o MP4 e o PDF e aloje onde quer que esteja o site de documentação.

O que a Trupeer produz que o GitBook não produz

Uma equipa de documentação de SaaS abre a Trupeer e começa uma gravação do ecrã do fluxo do produto que quer documentar: o fluxo de registo do utilizador, a configuração da integração, a configuração de funcionalidades, a geração da chave de API. A Trupeer AI trata do pós-processamento. As palavras de preenchimento desaparecem. Os efeitos de zoom e do cursor realçam os elementos da interface que importam. Um rascunho de vídeo de walkthrough e um rascunho de artigo escrito chegam juntos ao editor, ambos extraídos da mesma gravação de origem. O artigo escrito tem capturas de ecrã e passos numerados no próprio texto. O vídeo de walkthrough tem legendas, efeitos de zoom nos cliques críticos e slides de introdução e encerramento com brand-kit-applied. A partir daí, o saas implementation é um passo natural seguinte, já que o walkthrough já está capturado.

O que é enviado no final são dois recursos a partir de uma única gravação: um vídeo de walkthrough em MP4 pronto para incorporar no site de documentação do GitBook, publicar no YouTube ou alojar na Shared Page da Trupeer; e um artigo escrito (PDF, Word ou colado na plataforma de documentação) com o mesmo conteúdo do vídeo. A documentação de SaaS que tem ambos os formatos é usada em dois modos diferentes: os clientes no site de documentação lêem primeiro o artigo e veem o vídeo quando ficam com dúvidas; os clientes em emails de onboarding recebem a ligação para o vídeo; os clientes em tickets de suporte recebem a ligação relevante para a Shared Page. O GitBook é excelente no primeiro modo e não existe no segundo; a Trupeer foi criada para ambos. É por isso que se combina muito bem com as alternativas ao loom de que o walkthrough e a documentação vêm da mesma fonte.

Como funciona esta alternativa ao GitBook em três passos

Três passos cobrem o fluxo de produção desde a gravação do ecrã até aos recursos incorporáveis. Sem editor de vídeo, sem escritor separado, sem um passo de tradução separado.

Passo 1: Grave o fluxo do produto

Carregue em gravar no browser e percorra o fluxo do produto que o cliente precisa de aprender. Os casos de uso de documentação de SaaS que funcionam bem: registo e onboarding, configuração de integração, geração e autenticação de chaves de API, configurações comuns de funcionalidades, walkthroughs de troubleshooting. Para equipas de SaaS sem um gravador interno em mente, um avatar de IA com um guião digitado entrega o mesmo walkthrough que um vídeo com “talking-head”, sendo útil quando ninguém na equipa quer estar em câmara.

Passo 2: A IA gera o vídeo de walkthrough e o artigo escrito

As palavras de preenchimento e as pausas são removidas. Os efeitos de zoom e do cursor realçam onde o utilizador precisa de clicar ou o que precisa de ler no ecrã. Brand kit aplica o logótipo da empresa, cores, slides de introdução e encerramento. Um rascunho de vídeo de walkthrough e um rascunho de artigo escrito chegam juntos ao editor. O glossário personalizado apanha nomes de funcionalidades do produto, nomes de integrações e nomes de endpoints de API que a IA, de outra forma, não escreveria ou transcreveria corretamente.

Passo 3: Incorpore no site de documentação ou envie via Shared Page

Incorpore o vídeo MP4 na página de documentação do GitBook (ou Mintlify, ReadMe, Notion, Confluence, Document360, ou onde quer que estejam, na prática, as documentações de SaaS) usando o código padrão de incorporação de vídeo. Publique o artigo escrito ao lado no editor do site de documentação. Ou ignore totalmente o site de documentação e envie via uma ligação para uma Shared Page da Trupeer, que combina o leitor de vídeo, a transcrição, o artigo escrito e opções de incorporação numa única URL com marca que a equipa pode colar em emails de onboarding ou em respostas de suporte. Tradução para 65+ idiomas aplica-se a ambos os formatos no mesmo trabalho.

Quem usa a Trupeer em conjunto (ou em vez) do GitBook

A pessoa que chega a esta página é, normalmente, um responsável de documentação de SaaS, um gestor de relações com developers, um gestor de marketing de produto ou um especialista em educação de clientes a avaliar o GitBook como plataforma de documentação de SaaS para uma reestruturação da documentação e a perceber que a equipa também precisa de walkthroughs em vídeo que o GitBook não consegue produzir. Já analisaram as alternativas ao GitBook na categoria de alojamento de documentação: Mintlify (moderno, focado em developers, forte em OpenAPI), ReadMe (focado em documentação de API), Docusaurus (open source, construído pela Meta), Document360 (base de conhecimento com workflows), Notion (uso geral, utilizado por algumas equipas como ferramenta de documentação de SaaS), Confluence (wiki empresarial). Cada uma destas resolve o problema de alojamento e do editor. Nenhuma delas gera os walkthroughs em vídeo nem os artigos escritos correspondentes a partir de uma gravação do ecrã — e é essa lacuna que a Trupeer preenche como uma categoria diferente de software de documentação de SaaS.

O padrão que, na prática, funciona para a maioria das equipas de documentação de SaaS: use o GitBook (ou Mintlify, ou ReadMe) para o site de documentação em si, com a referência de API, as visões conceptuais, os artigos de troubleshooting e a estrutura geral. Use a Trupeer para os vídeos de walkthrough por artigo e para os artigos escritos correspondentes gerados automaticamente quando uma nova funcionalidade é lançada, quando uma integração muda ou quando a equipa percebe que a documentação existente apenas com texto não é suficiente. As duas ferramentas combinam-se numa experiência de documentação que tem tanto o conteúdo de texto alojado e pesquisável (força do GitBook) como o conteúdo visual de walkthrough (força da Trupeer). As equipas que tentam usar apenas uma destas opções acabam, de forma consistente, por ficar sem a outra metade.

Que tipo de documentação de SaaS a Trupeer trata bem

Os tipos de documentação de SaaS que mais beneficiam do emparelhamento entre vídeo e artigo escrito: conteúdos de onboarding e tour do produto (os primeiros 15 minutos dentro da app), walkthroughs específicos de funcionalidades (como configurar um webhook, como convidar um membro da equipa, como configurar single sign-on), guias de configuração de integrações (como ligar o Slack, como autenticar com a API, como configurar a exportação de dados), walkthroughs de troubleshooting (o que fazer quando X falha) e anúncios de atualização de funcionalidades (o que mudou no lançamento mais recente). A Trupeer AI trata de todos a partir do mesmo fluxo “gravação para documentação”.

De forma geral, a documentação de produto de SaaS que beneficia de mostrar o produto real a funcionar beneficia também da Trupeer. A documentação de SaaS que trata de conceitos, princípios de design, glossários, FAQs ou referência de API que não mostra um fluxo de UI fica melhor como texto no GitBook ou na plataforma de documentação que a equipa use. A versão honesta da proposta de valor: a Trupeer adiciona a camada de walkthrough em vídeo a qualquer plataforma de documentação de SaaS que a equipa já tenha. A equipa obtém o alojamento da documentação a partir do GitBook (ou das suas alternativas) e a produção dos walkthroughs a partir da Trupeer, em vez de ter de escolher entre uma ou outra e perder capacidades em qualquer dos casos. Tratar a Trupeer como uma ferramenta de documentação que produz conteúdo, em conjunto com uma plataforma de documentação que aloja esse conteúdo, dá à maioria das bibliotecas de documentação de produto de SaaS o melhor dos dois mundos.

Onde a Trupeer se encaixa ao lado do GitBook e do resto do mercado de plataformas de documentação

A Trupeer não é uma substituição da camada de alojamento do GitBook. O GitBook continua a ser o responsável pelo site de documentação no domínio personalizado, pela estrutura de wiki com páginas aninhadas, pelo editor colaborativo baseado em blocos, pelo controlo de versões em páginas individuais, pelas permissões públicas e privadas, pela pesquisa de texto completo e pela geração automática da referência OpenAPI. A Trupeer não tenta competir com nenhuma dessas funcionalidades. As equipas que procuram no mercado das alternativas ao GitBook uma substituição “equivalente” de plataforma de documentação (Mintlify, ReadMe, Docusaurus, Document360) devem escolher a partir dessa lista. As equipas que procuram uma alternativa ao GitBook porque a sua lacuna real é a falta de vídeos de walkthrough e a falta de documentação técnica em formato de vídeo estão a olhar para a página certa.

A Trupeer também não é uma substituição da camada de referência de API. A Mintlify, a ReadMe, a Stoplight e a Postman criam documentação interativa de referência de API a partir de especificações OpenAPI com consolas “try-it-now”, exemplos de código em várias linguagens e testes de autenticação. A Trupeer trata do walkthrough humano de como integrar com uma API (o fluxo conceptual, a configuração típica, as armadilhas), mas não da referência ponto a ponto dos endpoints. A maioria das equipas de SaaS junta as duas: documentação de referência de API na Mintlify ou na ReadMe, vídeos de walkthrough de integração e artigos escritos correspondentes na Trupeer.

O que a Trupeer substitui, mais rápido e com um custo de produção mais baixo do que as alternativas, é o trabalho manual de produzir conteúdo de walkthrough. Editores de vídeo, escritores técnicos e especialistas freelancers em documentação fazem este trabalho hoje; a equipa que compra a Trupeer reduz o custo por recurso de vários centenas de dólares (tempo do escritor mais tempo do editor) para menos de $50 por recurso (tempo de gravação do especialista no assunto mais processamento por IA). Numa biblioteca de documentação de SaaS com 100+ artigos, as poupanças de trabalho acumulam.

Tradução e atualizações para bases de utilizadores globais de SaaS

A maioria dos produtos de SaaS funciona com utilizadores internacionais desde o primeiro dia. A documentação que é enviada em inglês serve metade da base de utilizadores que lê inglês e tem desempenho inferior para todos os outros. A tradução no GitBook (e na maioria das plataformas de documentação) exige ou reescrita manual ou serviços externos de tradução, ambos suficientemente caros para que a maioria das equipas de documentação de SaaS ignorem a tradução por completo. A Trupeer traduz a narração do vídeo e o artigo escrito correspondente no mesmo trabalho, para espanhol, português, hindi, mandarim, francês, alemão, japonês, árabe, ou qualquer uma das 65+ línguas que a base de utilizadores fala. A clonagem de voz mantém a voz do apresentador original nas versões traduzidas, pelo que a documentação localizada parece intencional e não dublada.

As atualizações são o outro eixo em que a documentação de SaaS se degrada rapidamente. Uma mudança na UI quebra o vídeo de walkthrough da última trimestre, uma atualização de funcionalidade torna o artigo escrito existente enganador, uma mudança na integração quebra todo o guia de configuração. A maioria das equipas de documentação de SaaS lida com isto permitindo silenciosamente que a documentação fique desatualizada e respondendo às perguntas nos tickets de suporte sempre que um cliente se depara com um artigo agora desatualizado. A Trupeer trata das atualizações voltando a gravar apenas o passo alterado. A IA reprocessa apenas esse segmento, atualizando no local tanto o vídeo como o artigo escrito, e o cliente no site de documentação (ou na incorporação dentro do GitBook) vê automaticamente a versão atual. Ao emparelhar este fluxo de trabalho com o Trupeer AI SOP builder, cobre tanto a documentação de SaaS voltada para o cliente como os procedimentos operacionais internos padrão que ficam ao lado dela.