Caderno de respostas para FAQ: respostas para copiar e colar em comentários
Para uso interno — respostas para copiar e colar no Reddit, X, IndieHackers, Product Hunt, HackerNews e em comentários sob publicações de concorrentes.
Formato por pergunta: TL;DR (1–2 frases, cabe em um tweet) + Longa (3–5 frases para threads e comentários em blogs).
Tom: voz honesta de fundador. Nada de linguagem de marketing vazia, nada de "plataforma revolucionária com tecnologia de IA". Comece pelo que ela faz concretamente, mencione a contrapartida e inclua um link para a documentação, se for relevante.
Fonte de referência para números e fatos: a página de preços e a visão geral da documentação. Se algum número aqui discordar desses materiais, eles prevalecem — corrija este arquivo.
1. Geral#
O que é o Docsbook?#
Em resumo: O Docsbook transforma um repositório público do GitHub em um site de documentação em poucos segundos. Cole github.com/user/repo, o site aparece em docsbook.io/user/repo, e cada push para a branch principal o atualiza automaticamente — detectado por um temporizador em até 24 horas, e não por um webhook; portanto, diga "sem etapa de build", nunca "instantaneamente".
Em detalhes: É uma plataforma de documentação hospedada voltada para pessoas que querem manter sua documentação como Markdown no GitHub — não em um CMS proprietário. Não há CI/CD para configurar nem docusaurus.config.js para monitorar. Você obtém o site de documentação, um chatbot de IA integrado treinado com seu conteúdo, traduções por IA para 15 idiomas com indexação SEO separada, análises completas e um servidor MCP para que agentes de IA possam gerenciar o workspace. Domínio personalizado com SSL gratuito é um adicional do plano Business. O plano gratuito é real — não é um período de avaliação.
Para quem é?#
TL;DR: Fundadores de SaaS, equipes de ferramentas de desenvolvimento e mantenedores de OSS que desejam documentação séria sem gastar duas semanas na configuração do Docusaurus ou uma assinatura por editor no GitBook.
Longo: O ponto ideal é uma pequena equipe que já escreve Markdown no GitHub e deseja o site publicado, pesquisa, chat de IA, traduções e análises — sem precisar gerenciar a infraestrutura. Equipes que também desejam um domínio personalizado ou webhooks sobem para o Business. Se você tem um redator técnico e um sistema de design personalizado, o Docusaurus provavelmente ainda é melhor. Se você tem uma equipe de documentação de 20 pessoas e requisitos de SSO corporativo, o GitBook se encaixa. Todos os outros são para quem o Docsbook foi criado.
Quanto tempo realmente leva para publicar?#
TL;DR: 5–30 segundos. Conecte o GitHub, aponte para um repositório, o site está ao vivo. Sem etapa de construção, sem implantação.
Longo: A primeira publicação é a mais longa porque indexamos o repositório através da API do GitHub. Depois disso, cada push para o main atualiza o site em segundos — sem GitHub Action, sem implantação do Vercel para você manter. O pipeline de indexação lê README.md e a pasta docs/, analisa com markdown-lsp (nosso parser LSP de código aberto, AST via unified+remark em vez de regex frágil), e renderiza com shiki + rehype.
Onde meu conteúdo realmente vive?#
TL;DR: No seu repositório do GitHub. O Docsbook lê a partir dele, mas nunca escreve de volta. Cancele a qualquer momento — seu Markdown permanece exatamente onde estava.
Long: Esta é a história anti-lock-in. Notion, GitBook e Mintlify (principalmente) possuem seu conteúdo — para sair, você precisa exportar. Com o Docsbook, a fonte da verdade é seu repositório. Nós armazenamos em cache e indexamos, mas não armazenamos o conteúdo de forma autoritativa. As configurações do espaço de trabalho (branding, configuração de IA, domínio, análises) vivem em nosso Postgres; se você sair, essas configurações desaparecem — seus documentos não.
2. Preços & planos#
Quanto custa?#
TL;DR: Não vendemos níveis. Cada projeto tem seu próprio saldo e o saldo é gasto no uso de IA — o site, hospedagem, domínio personalizado e visualizações de página não custam nada. Números atuais: https://docsbook.io/pricing
Longo: Publicar um site de docs a partir de um repositório do GitHub, hospedá-lo, servi-lo em seu próprio domínio com SSL, e cada leitor que abre uma página — nada disso consome nada. O que é medido é a IA: perguntas ao assistente e execuções de tradução são cobradas contra um saldo mantido por projeto, ao preço real do provedor para o modelo que respondeu, mais nossa margem, e o painel mostra o modelo, sua taxa e a margem para que a dedução seja verificável. A cobrança é por conta, não por assento, então ninguém paga por um colega que possa corrigir um erro de digitação. Não cite um preço de mim — https://docsbook.io/pricing é gerado a partir das constantes de preços ao vivo em cada solicitação, então está correto no momento em que você o abre.
O plano gratuito é um teste?#
TL;DR: Não há teste, porque não há nível para testar. Execute um site de documentação pública real com branding personalizado, navegação, tema, fontes, seu próprio domínio e SSL, e não pague nada — o uso de IA é a única coisa que consome um saldo.
Longo: Eu (Dan) queria que mantenedores de OSS e hackers independentes usassem a ferramenta sem pensar em preços, então o site em si não é pelo que cobramos. O que custa dinheiro é o que nos custa dinheiro: inferência de LLM. Se seu repositório é público e você quer um bom site de documentação com um domínio personalizado, não há nada para comprar. Quando você começa a depender do assistente ou das traduções, é aí que o saldo importa.
Por que o Pro é uma assinatura e não um plano vitalício?#
Resumo: Costumávamos vender um plano PRO vitalício de pagamento único; ele não é mais oferecido, e os clientes vitalícios existentes foram preservados. O que o substituiu é o pagamento conforme o uso, porque o chat de IA e as traduções têm um custo de inferência contínuo que um preço vitalício fixo não pode cobrir.
Longo: Um preço vitalício fixo não poderia escalar com a quantidade de inferência de LLM que um espaço de trabalho realmente usa — um usuário pesado poderia custar mais em um mês do que pagou uma vez. Portanto, o modelo agora cobra exatamente isso: o uso da IA, medido contra um saldo por projeto, com o site em si gratuito. Se você comprou o PRO vitalício de pagamento único original antes da mudança, você mantém seus recursos originais sem custo adicional; esse plano foi aposentado e não está mais à venda.
O que acontece se eu exceder os limites de solicitação de IA?#
TL;DR: O uso da IA para quando o saldo do projeto acaba — você nunca é cobrado além do que colocou — e você o reabastece quando quiser mais. Você também pode trazer sua própria chave OpenAI / Anthropic / Gemini / OpenRouter e pagar diretamente ao provedor.
Longo: Cada projeto possui seu próprio saldo e cada chamada de IA é deduzida dele pelo preço real do modelo mais nossa margem, ambos mostrados no painel. Quando o saldo chega a zero, o assistente para de responder em vez de cobrar mais — não há excesso e nenhuma fatura surpresa. Reabasteça o projeto e ele retoma. Você também pode conectar sua própria chave de API nas configurações de IA e direcionar solicitações através do seu provedor, caso em que não medimos nada. Números atuais: https://docsbook.io/pricing
Existe uma política de reembolso?#
TL;DR: Sim — me envie um e-mail (dan@docsbook.io) dentro de 30 dias, sem perguntas, reembolso total através do Paddle.
Longo: A confiança é mais importante do que qualquer venda única. Se o Docsbook não se adequar ao seu fluxo de trabalho, prefiro reembolsar do que ter um cliente insatisfeito dizendo às pessoas para não usá-lo. O Paddle cuida da mecânica de reembolso, geralmente em alguns dias úteis.
3. Concorrentes#
Como isso é diferente do GitBook?#
TL;DR: Mesmo resultado (um site de docs hospedado), uma estrutura de preços completamente diferente — o GitBook cobra por site e por editor, nós cobramos pelo uso de IA e nada pelo site — e seu conteúdo permanece no seu repositório do GitHub.
Longo: O preço do GitBook tem dois eixos ao mesmo tempo: uma taxa por site e uma taxa por usuário para todos que editam conteúdo. Em 2026-09-03, a página de preços deles listava Gratuito a $0 por site/mês com um usuário, Premium a $65 por site/mês mais $12 por usuário/mês, e Ultimate a $249 por site/mês mais $12 por usuário/mês — confira https://www.gitbook.com/pricing para os números de hoje. O conteúdo vive no CMS do GitBook, então sair significa uma exportação. Conosco, o site não custa nada, independentemente de quantas pessoas o editam, o uso de IA é medido contra um saldo por projeto, e seu Markdown nunca sai do seu repositório do GitHub. A troca é real: o GitBook tem um editor WYSIWYG mais rico; nós não temos um — você escreve em Markdown.
Como isso é diferente do Docusaurus?#
TL;DR: Docusaurus é um framework React que você hospeda. Docsbook é um produto hospedado. 30 segundos vs. 2–3 dias de configuração + manutenção contínua de um aplicativo Node.js.
Longo: Docusaurus é fantástico se você deseja controle total e tem uma equipe que gosta de gerenciar o pipeline de construção, plugins, substituições de tema e um alvo de implantação. Docsbook é para pessoas que querem o site de documentação sem possuir o framework. Também incluímos pesquisa, chat de IA, traduções e análises, que são plugins/serviços separados em uma configuração do Docusaurus. Se você já implementou o Docusaurus, não migre — ele funciona bem. Se você está começando hoje e não precisa de personalização em nível de framework, o Docsbook te leva lá em segundos.
Como isso é diferente do Mintlify?#
TL;DR: Conjunto de recursos comparável (documentos hospedados, IA), mas o Mintlify te direciona para o MDX em sua estrutura. O Docsbook lê Markdown simples de qualquer repositório do GitHub e é geralmente mais barato.
Longo: O Mintlify é bom — bem projetado, bem comercializado. Onde nós diferimos: (1) trabalhamos com qualquer repositório público do GitHub que tenha Markdown em README.md ou docs/, sem configuração específica do projeto necessária; (2) eles vendem um plano mensal, nós medimos o uso da IA contra um saldo por projeto e não cobramos nada pelo site — compare https://mintlify.com/pricing com https://docsbook.io/pricing; (3) expomos um servidor MCP completo, para que os agentes de IA possam gerenciar seu espaço de trabalho programaticamente — ler o gráfico de documentos, pesquisar por símbolo, mudar a marca. A experiência central de documentos deles é mais polida desde o início; a nossa se aproxima mais à medida que você personaliza.
Como isso é diferente do Notion?#
TL;DR: O Notion é ótimo para wikis internas. Ruim para documentos públicos — sem SEO real, sem chat de IA treinado no conteúdo, sem domínio personalizado na maioria dos planos, e o Google não indexa da mesma forma que indexa sites de documentos.
Long: Vejo muitas equipes usando o Notion como "documentos" e depois se perguntando por que ninguém os encontra. As páginas do Notion não se estruturam como documentos (sem hierarquia de cabeçalhos adequada para SEO), não expõem sitemap.xml, não têm um chat de IA embutido para visitantes, e não geram llms.txt para agentes de IA. O Docsbook é construído especificamente para documentos que precisam ser encontrados — pelo Google, pelo ChatGPT, pela Perplexity. Mantenha o Notion para sua wiki interna; coloque documentos públicos em algum lugar construído para isso.
Como isso é diferente do Readme.io?#
TL;DR: Readme.io é focado em documentação de API e vende IA como um complemento pago em cima do plano (em 2026-09-03, sua página listava Starter $0/mês, Pro $250/mês faturado anualmente, e "Ask AI" a $150/mês — veja https://readme.com/pricing). Docsbook é mais amplo — qualquer documentação de qualquer repositório GitHub — e a IA é medida pelo uso em vez de ser vendida como um nível.
Long: Se você tem uma especificação OpenAPI e deseja uma referência de API polida com teste imediato, Readme.io é feito para esse trabalho exato e faz isso bem. Docsbook é uma plataforma de documentação mais geral — guias, referências, postagens de blog, qualquer coisa que você possa colocar em Markdown. Se você precisar de ambos, muitas equipes usam Readme.io para referência de API e Docsbook para o site de documentação mais amplo.
4. Chat de IA & traduções#
Como funciona o chat de IA?#
Resumo: Ele é treinado apenas com a sua documentação, não com a web aberta. Os visitantes fazem perguntas, ele responde com citações das suas páginas de documentação.
Detalhes: O fluxo é Pesquisa → Leitura → Resposta. O chatbot recupera seções relevantes do seu gráfico de documentação indexado, então sintetiza uma resposta com o LLM, citando as páginas de onde obteve as informações. Você pode configurar perguntas sugeridas, o prompt do sistema, ganchos pré/pós LLM e o provedor do modelo (nós usamos por padrão o OpenRouter openai/gpt-4o-mini, mas você pode inserir sua própria chave OpenAI / Anthropic / Gemini). Respostas em streaming, análises de uso completas e uma get_ai_questions ferramenta MCP para que você possa ver o que seus usuários estão realmente perguntando.
Quais provedores de IA posso usar?#
TL;DR: OpenRouter (padrão), OpenAI, Anthropic, Gemini. Você pode trazer sua própria chave de API e escolher qualquer modelo que o provedor suporte.
Long: O padrão é OpenRouter com openai/gpt-4o-mini porque é barato e bom o suficiente para a maioria das perguntas e respostas de documentos. Você substitui no nível do espaço de trabalho nas configurações de IA — cole sua chave, escolha o modelo, pronto. Solicitações através da sua própria chave não contam contra o limite mensal. Esta é também a forma como você pode direcionar para uma implantação privada/dedicada se a conformidade exigir.
Como funcionam as traduções de IA?#
Resumo: 15 idiomas (EN, ES, FR, DE, PT, IT, RU, ZH, JA, KO, AR, HI, TR, PL, NL). Cada versão traduzida é indexada no Google como uma página separada, com o hreflang apropriado.
Longo: Você ativa um idioma no espaço de trabalho, o Docsbook gera a tradução e a versão traduzida se torna uma página real em docsbook.io/[owner]/[repo]/[lang]/.... O Google trata cada idioma como uma URL indexável distinta — assim, você obtém SEO separado para cada mercado. Há um seletor de idioma na barra lateral ou no cabeçalho (configurável), e detectamos automaticamente o idioma do visitante com franc. O plano Business tem um limite mensal de tradução maior do que o Pro. Se você tiver seu próprio fluxo de trabalho de tradutor, defina o modo de tradução para external e envie traduções através da ferramenta MCP ou webhook.
Posso revisar traduções antes de serem publicadas?#
TL;DR: Sim — Pro e Business suportam uma fila de aprovação pendente. A tradução chega como um rascunho, você aprova via MCP (approve_translation) ou o painel, e então é publicada.
Longo: Isso é importante para idiomas onde você tem um falante nativo na equipe e deseja uma verificação antes de enviar. Também há list_pending_translations e get_translation ferramentas MCP para que um agente possa pré-selecionar rascunhos e apenas apresentar aqueles que parecem questionáveis.
5. SEO & descoberta de IA#
O Docsbook gera llms.txt?#
TL;DR: Sim. Cada espaço de trabalho recebe /llms.txt e /llms-full.txt automaticamente, sem nada para habilitar. Também em nível de plataforma: docsbook.io/llms.txt.
Longo: llms.txt é o padrão emergente para informar agentes de IA (Perplexity, ChatGPT Search, Cursor, Cline) o que seu site é e como está estruturado. Nós o geramos a partir do seu gráfico de documentos — lista de páginas com títulos e descrições, em um formato que os clientes de IA realmente analisam. llms-full.txt é o mesmo, além do conteúdo completo. Ambos funcionam sem configuração; eles existem no momento em que seu espaço de trabalho é indexado. Se um assistente então cita você depende do seu conteúdo, não do arquivo — nenhuma plataforma pode prometer uma citação, e nós não prometemos.
E quanto ao SEO regular?#
TL;DR: Integrado. Meta tags, OpenGraph, sitemap.xml, JSON-LD (WebSite, Organization, SoftwareApplication, FAQPage), URLs canônicas, indexação separada por idioma — nada para ativar e nada para pagar.
Longo: Cada página recebe um <title>, <meta description>, imagem OpenGraph e blocos JSON-LD para dados estruturados. O sitemap é gerado automaticamente e notifica o Google sobre atualizações. As traduções são expostas com hreflang. Um domínio personalizado mais a configuração de SEO significa que um site Docsbook se comporta como um verdadeiro site de documentação para o Google, não como uma SPA. Esta é a principal razão pela qual as equipes nos escolhem em vez do Notion para documentação pública.
Os motores de busca de IA realmente citarão meus documentos?#
TL;DR: Às vezes, e ninguém pode prometer mais do que isso. O Docsbook remove os bloqueadores mecânicos — HTML renderizado no servidor, cabeçalhos limpos, sitemap, llms.txt, acesso de rastreadores — mas se um motor cita você depende do seu conteúdo e do motor, e o mesmo prompt retorna fontes diferentes de execução para execução.
Longo: A citação de busca de IA depende de (1) ser indexável (nós cuidamos disso), (2) ser estruturada para que o modelo possa extrair reivindicações concretas (hierarquia de cabeçalhos, blocos de código, listas — seu Markdown já faz isso), (3) ter llms.txt (nós geramos isso), (4) ser autoritativa para o tópico (isso depende de você e de como você escreve). Do lado técnico, o Docsbook remove os bloqueadores usuais. Para agentes que trabalham diretamente contra seu repositório, markdown-lsp adiciona navegação estilo LSP (doc_outline, doc_search_symbols, doc_resolve_link, etc.) para que eles possam navegar precisamente em vez de absorver HTML bruto.
6. Tecnologia & integrações#
Qual pilha de tecnologia o Docsbook utiliza?#
Resumo: Next.js 16 no Vercel, PostgreSQL no Neon, cache Redis, Drizzle ORM. IA via OpenRouter/OpenAI/Anthropic/Gemini. Chato, rápido, escalável.
Longo: O frontend é Next.js 16 App Router + React 19 + Tailwind 4 + shadcn/ui. A autenticação é next-auth v5 com GitHub OAuth. O banco de dados é Neon serverless Postgres com migrações Drizzle. O pipeline Markdown é unified + remark-parse + remark-gfm + remark-rehype + rehype-pretty-code + shiki. O servidor MCP é @modelcontextprotocol/sdk 1.29 com OAuth 2.0 completo. A hospedagem é Vercel, incluindo domínios personalizados, faturamento através do Paddle, análises através do Axiom.
Funciona com repositórios privados?#
TL;DR: Repositórios públicos funcionam imediatamente. Repositórios privados passam por autenticação OAuth do GitHub — o mesmo fluxo, com acesso de leitura ao repositório específico.
Longo: Quando você conecta o GitHub, você concede acesso aos repositórios que deseja indexar. Para projetos OSS, este é o fluxo de repositório público sem escopos adicionais. Para repositórios privados, você autoriza repositórios específicos através do GitHub App e nós os lemos com o token do usuário. Nunca armazenamos o conteúdo de forma autoritativa — apenas o gráfico indexado e o cache, que podemos invalidar a qualquer momento.
Posso usar um domínio personalizado?#
TL;DR: Sim, no Business. Aponte um CNAME para Docsbook, nós provisionamos o certificado SSL, pronto. docs.yourcompany.com funciona em poucos minutos.
Longo: Domínios personalizados passam pela API de domínio da Vercel. Você adiciona docs.yourcompany.com no painel de controle do workspace ou via a ferramenta update_domain MCP, define um CNAME no seu provedor de DNS, e a Vercel emite o certificado SSL automaticamente. Nós também fazemos proxy através de /docs-proxy/[[...path]]/ para que a URL permaneça limpa e as análises continuem funcionando.
Existe um servidor MCP?#
TL;DR: Sim — um servidor MCP completo OAuth 2.0 em https://docsbook.io/api/mcp/server, com ferramentas para gerenciamento de espaço de trabalho, branding, análises, webhooks e traduções. O servidor retorna sua própria lista de ferramentas na conexão, então não cite uma contagem de mim. Para busca de doc-graph use markdown-lsp localmente, não o MCP hospedado.
Longo: Conecte o MCP hospedado com claude mcp add --transport http https://docsbook.io/api/mcp/server. Após o OAuth, o agente obtém ferramentas para gerenciamento de espaço de trabalho (criar, branding, UI), chat de IA (prompt do sistema, hooks), traduções (aprovar, enviar, excluir), análises (perguntas, não respondidas, buscas falhadas) e webhooks (registrar, listar, reproduzir). Para operações de doc-graph estilo LSP — esboço, busca de símbolos, resolução de links, referências — use markdown-lsp localmente em vez de (npx markdown-lsp <subcommand> ./docs). Ele analisa o repositório no disco, que é mais rápido e mais barato do que ir pela rede.
7. Segurança, privacidade & bloqueio#
O que acontece com meus dados se eu cancelar?#
TL;DR: Seu Markdown permanece no seu repositório do GitHub. Nós excluímos as configurações do espaço de trabalho (branding, configuração de IA, análises) mediante solicitação. Nenhum "exportar" necessário — seu conteúdo nunca foi nosso.
Longo: Esta é a diferença estrutural em relação ao GitBook/Notion. Com eles, o cancelamento significa um ritual de exportação para recuperar seu conteúdo. Com o Docsbook, seu conteúdo sempre esteve no seu repositório — quando você desconecta o espaço de trabalho, seu repositório permanece inalterado. O que mantemos é metadados do espaço de trabalho no Postgres (que é pelo que você está pagando) e eventos de análise no Axiom, ambos os quais excluímos mediante solicitação.
Onde os dados estão hospedados?#
TL;DR: Vercel (edge global), Neon Postgres (regiões dos EUA/EU), cache Redis, Axiom para logs. Toda a infraestrutura nos EUA/EU.
Longo: Infraestrutura padrão SaaS hospedada. Vercel gerencia HTTP e CDN globalmente. Neon é Postgres sem servidor, operamos em sua região padrão com recuperação em ponto no tempo. Redis é para armazenar em cache o índice de habilidades. Logs e análises vão para Axiom. Se você precisar de um compromisso específico de região para conformidade, fale comigo — por enquanto, implantamos na pegada padrão Vercel/Neon.
O código-fonte é aberto?#
Resumo: O Docsbook em si é de código fechado. markdown-lsp (nosso parser) e docs-skills (o catálogo de habilidades de IA) são de código aberto no GitHub.
Longo: A plataforma é fechada, mas disponibilizamos como OSS as partes que beneficiam o ecossistema mais amplo. markdown-lsp é nosso parser estilo LSP que transforma Markdown em um gráfico de documentos estruturado — ele alimenta a busca local no gráfico de documentos e é útil para qualquer pessoa que esteja construindo ferramentas de documentação. docs-skills é um catálogo público de 25 arquivos SKILL.md para agentes de IA (docs-analyze, docs-seo, etc.) — funciona com o Docsbook MCP e também de forma independente.
8. Objeções & resistência#
"Por que não usar apenas o Docusaurus, é gratuito?"#
Resumo: Docusaurus é gratuito em dólares, não em tempo. Dois dias de configuração mais a manutenção contínua de um aplicativo Node.js é dinheiro real no momento em que você cobra suas próprias horas — faça essa conta com sua própria taxa.
Longo: Docusaurus é ótimo e eu o recomendo para equipes que desejam controle total. Mas "gratuito" é a estrutura — você ainda precisa hospedá-lo, manter a construção, gerenciar dependências, adicionar um serviço de busca (Algolia $$$), adicionar análises, adicionar chat de IA (personalizado), adicionar i18n (personalizado), etc. O custo total de propriedade ao longo de um ano é significativo. Docsbook troca o teto de personalização por tempo de configuração e recursos agrupados. Ambas são escolhas válidas.
"Pagar por um site de documentação parece caro."#
TL;DR: Compare com o que mais está disponível — GitBook, Mintlify e Readme.io começam bem acima disso para um conjunto de recursos comparável. Gratuito cobre um site de documentação pública real sem necessidade de IA.
Long: Eu entendo a reação à primeira vista, mas não temos preços como os outros. GitBook, Mintlify e Readme vendem níveis — uma assinatura mensal fixa, e no GitBook uma taxa por usuário além disso. Nós não vendemos níveis de forma alguma: cada projeto tem seu próprio saldo, e esse saldo é gasto no uso de IA. Publicar o site, hospedá-lo, o domínio personalizado e cada página que um leitor abre não consomem nada disso. Portanto, se você quiser um site de documentação pública com branding e sem IA, não há nada a pagar. Os números atuais estão em https://docsbook.io/pricing, que é gerado a partir das constantes de preços ao vivo em cada solicitação — não cite um preço de mim, cite-o de lá.
"Por que apenas GitHub? E se meu código-fonte estiver no GitLab/Bitbucket?"#
TL;DR: Apenas GitHub hoje. GitLab e Bitbucket estão no roteiro, mas não em breve. Se você tiver uma necessidade ativa, me envie um e-mail — isso ajuda a priorizar.
Longo: Resposta honesta: GitHub é onde a grande maioria dos projetos de OSS e ferramentas de desenvolvimento que estamos visando realmente mantém seu código, e apoiar um provedor de forma profunda é melhor do que apoiar três de forma superficial. O suporte ao GitLab é plausível porque sua API é semelhante; o Bitbucket é mais difícil. Se o suporte ao GitLab desbloquear você, me avise — eu mantenho uma lista e é isso que faz os recursos avançarem.
"Como isso não vai ser eliminado pelo GitHub adicionando hospedagem nativa de documentos?"#
Resumo: O GitHub já possui Pages e Wikis — nenhum deles é uma plataforma real de documentos. Mesmo que eles lancem uma, chat de IA / traduções / análises / MCP / domínio personalizado são os diferenciais.
Longo: O GitHub Pages existe há uma década e as pessoas ainda usam Docusaurus, GitBook, Mintlify, Readme.io. Por quê? Porque "hospedagem de HTML estático de um repositório" é a parte fácil — a parte difícil é busca, IA, i18n, SEO, análises, UX de domínio personalizado, painel e faturamento para compradores não técnicos. O risco não é o GitHub adicionando hospedagem de documentos; o risco é um dos jogadores existentes fazendo a combinação de IA + nativo do GitHub melhor. Essa é a referência que nos impomos.
"Parece ótimo, mas eu não confio em uma empresa de uma pessoa só com meus documentos."#
TL;DR: Justo. Seu conteúdo está no seu repositório do GitHub, não em nosso banco de dados — então, no pior cenário (nós desaparecemos), você perde o site hospedado, não seus documentos. Mova-os para o Docusaurus em um dia.
Longo: Esta é a resposta real para "e se o Docsbook desaparecer." Seu Markdown está no seu repositório. As configurações do espaço de trabalho são recuperáveis (nós as expomos via MCP e API). A URL do site quebraria, mas o conteúdo permanece intacto. Compare com GitBook/Notion onde a rotatividade = dor de exportação. A história de lock-in é a razão estrutural pela qual o risco de pequenos fornecedores é menor aqui do que com concorrentes que possuem conteúdo.
Como manter este caderno atualizado#
A parte difícil não é escrever o FAQ uma vez — é mantê-lo preciso à medida que o produto muda e novas perguntas surgem de conversas reais. Opções concretas que Dan pode configurar:
Puxar automaticamente perguntas reais da produção#
- Ferramentas MCP que já temos:
get_ai_questions,get_ai_unanswered,get_failed_searches,get_popular_searches,get_negative_feedback. Execute um cron semanal que puxe isso para o espaço de trabalhodocsbook.io(já que nosso próprio site de documentação está no Docsbook) — revela as perguntas que nossos próprios visitantes estão fazendo, mas que a IA não conseguiu responder, que é a matéria-prima de maior sinal para novas entradas de FAQ. - Script:
scripts/faq-collect.ts— chama essas ferramentas MCP, remove duplicatas em relação às perguntas existentes neste arquivo, publica um resumo no Slack/Notion.
Extrair de canais sociais (necessita de acesso MCP)#
- Reddit MCP — leia comentários em
r/SaaS,r/devops,r/programmingmencionando "GitBook", "Docusaurus", "Mintlify", "hospedagem de docs". Perguntas reais de fora do nosso público existente. - X/Twitter MCP — o mesmo, mas para tweets mencionando concorrentes ou "site de docs".
- Discord/Slack — se tivermos uma instância, extraia perguntas de suporte. Ainda não existe.
- HackerNews — A API Algolia HN é pública, não é necessário MCP; um script de 50 linhas captura todas as menções ao Docsbook/concorrente.
Crie uma habilidade comment-reply#
Uma .claude/skills/comment-reply/SKILL.md que:
- Recebe entrada: texto do comentário + plataforma alvo (Reddit / X / HN / IH).
- Classifica qual entrada de FAQ corresponde (ou "sem correspondência").
- Retorna o TL;DR para plataformas estilo X/HN, a versão longa para Reddit/IH, com formatação apropriada para a plataforma.
- Se não houver correspondência — elabora uma nova entrada e propõe anexá-la a este arquivo.
Útil como um alias de CLI: claude comment-reply "<paste comment here>" --platform reddit.
Crie uma habilidade update-faq#
Uma habilidade semanal que:
- Obtém novas perguntas via
get_ai_questions/get_failed_searches. - Compara com este arquivo.
- Para cada cluster não respondido de >3 perguntas semelhantes, elabora uma nova entrada de FAQ no formato deste arquivo e abre um PR.
- Também sinaliza entradas onde os números em README.md se desviaram do que está citado aqui.
Lista de verificação de manutenção manual (enquanto isso)#
- Cada lançamento que altera preços → atualizar a Seção 2.
- Cada nova menção de concorrente no mercado → considerar adicionar à Seção 3.
- A cada trimestre → verificar os números do README.md em relação aos números citados aqui.
- Cada nova ferramenta MCP → referenciá-la na Seção 6 ou "Como manter isso atualizado".