Fern

O Fern constrói bibliotecas cliente projetadas por especialistas de cada idioma em vez de um modelo genérico. Os SDKs gerados trazem tipos fortes, documentação embutida e tratamento de erros familiar, de modo que um desenvolvedor de Python e um de TypeScript recebem algo que parece nativo. Um SDK de OpenAPI vindo de uma ferramenta genérica raramente é tão refinado. Isso importa porque os desenvolvedores adotaram a troca de um gerador genérico justamente para escapar das reclamações sobre clientes desajeitados e difíceis de usar.

Sua documentação vive no seu repositório como o restante do código. As mudanças passam pelo Git, os revisores veem as diferenças nas pull requests e qualquer agente de programação pode redigir ou atualizar conteúdo. Equipes que já tratam infraestrutura como código costumam achar esse fluxo natural, e ele elimina a etapa de copiar e colar que normalmente deixa a documentação para trás em relação à API. Encaixa sem mais. Acabaram as páginas obsoletas.

O chat de IA integrado deixa os leitores fazer perguntas e receber respostas extraídas da sua documentação. Como as respostas se apoiam no seu conteúdo, elas evitam as respostas genéricas que saem de um modelo que responde a partir do conhecimento geral. Para um leitor travado em um endpoint específico, essa é a diferença entre uma resposta útil e uma que apenas soa plausível. Acabou o chute.

O Fern expõe sua documentação e sua API por meio de um servidor Model Context Protocol, e entrega Markdown limpo com um arquivo llms.txt gerado automaticamente. Juntos, esses recursos tornam sua API consultável por ferramentas de IA e agentes de programação capazes de ler documentação estruturada. Se seus usuários constroem com assistentes de IA, esta é uma forma prática de esses assistentes consultarem coisas em tempo real.

O Fern aceita REST, WebSockets e GraphQL, além dos protocolos AsyncAPI e gRPC. Do lado das especificações, ele lê OpenAPI, OpenAPI Overlays, OpenAPI Arazzo, AsyncAPI, gRPC, GraphQL, OpenRPC e seu próprio formato de definição. Essa variedade significa que a maioria das equipes pode apontar o Fern para a especificação que já tem em vez de reescrevê-la. Aponta e pronto.

O plano gratuito inclui um domínio e um subcaminho personalizados, e os planos pagos acrescentam CSS, JavaScript e componentes React sob medida, além de layouts personalizados e integração com sistemas de design. Você também pode configurar links de pré-visualização, otimizações de SEO e proteção por senha para documentação privada, de modo que o site de referência combine tanto com sua marca quanto com suas regras de acesso. Escala quando você precisa.