Visão Geral Técnica
Read the Docs é uma plataforma de hospedagem e construção de documentação voltada para equipes de engenharia e desenvolvedores. Compila e publica documentação diretamente de repositórios Git, suportando Sphinx, MkDocs e outras ferramentas de código aberto. Oferece controle de versão, pré-visualizações de pull requests e autenticação integrada, operando sob um modelo SaaS comercial para empresas e uso gratuito permanente para projetos de código aberto.
Avaliação dos Analistas: Prós e Limitações
Vantagens Comprovadas
- Suporte nativo para múltiplas versões de documentação vinculadas a branches ou tags do Git.
- Pré-visualizações automáticas de documentação geradas em cada pull request.
- Hospedagem gratuita permanente garantida para projetos de código aberto e comunitários.
Considerações Técnicas
- Dependência de infraestrutura em nuvem que pode sofrer interrupções ocasionais por ataques ou falhas.
- Recursos avançados de controle de acesso e SSO corporativo são restritos aos planos comerciais pagos.
Capacidades e Recursos Técnicos
7/7ScorecardMostrar detalhesOcultar detalhes
Scorecard Técnico: Read the Docs
Tempo até Valor e Ajuste por Segmento: Read the Docs
Implantação quase instantânea com fricção técnica mínima.
Requer consulta à documentação técnica e configuração básica de credenciais.
Índice de Ajuste por Tamanho de Organização
Preços e TCOMostrar detalhesOcultar detalhes
Preços
Modelo: FREEMIUM.
Planos disponíveis:
- Community (Open Source)$0/mês
- Standard / Enterprise$50/mês
Verificação de Plano Gratuito:
- Sem cartão de crédito obrigatório
- Restrito a uso pessoal / não comercial
- Uso ilimitado sem expiração
- Sem marcas d’água obrigatórias
Riscos de Faturamento e Cláusulas Ocultas: Read the Docs
Read the Docs reserva a integração com provedores de identidade (Okta, Azure AD, Google Workspace) exclusivamente para seu plano corporativo mais caro, penalizando equipes em crescimento.
"Enable SSO with GitHub or GitLab to manage permissions from one place."
Citação verificada: /pricing
Gratuito permanentemente para projetos de código aberto e comunitários com suporte padrão.
- Os planos corporativos exigem cotações personalizadas que podem escalar com base no volume de assentos e minutos de build.
"Always free for open source and community projects. We've hosted open source documentation since 2010 — Flask, Jupyter, Godot, and thousands more trust us to keep their docs online and searchable."
Citação verificada: /pricing
Projeção de Custo Total de Propriedade (TCO): Read the Docs$0.00/moEstimativa determinística de custos em 12 e 36 meses conforme o tamanho da equipe, incluindo impostos SSO e descontos por pagamento anual.Mostrar detalhesOcultar detalhes
Simulador de Cobranças por Consumo: Read the DocsQuanto custa o uso ao escalarDetecte taxas por excesso de cota antes de impactar o orçamento de engenharia.Mostrar detalhesOcultar detalhes
Estratégia de Aquisição e Descontos: Read the DocsPlaybook de Negociação B2BNível de interlocução corporativa com maior capacidade de aprovar exceções orçamentárias.Mostrar detalhesOcultar detalhes
Segurança e SaídaMostrar detalhesOcultar detalhes
Padrões de Conformidade e Segurança: Read the Docs
Runbook de Portabilidade e Saída: Read the DocsHTML · PDF · EPUBProtocolo de extração de dados e garantias de migração técnica para mitigar o aprisionamento tecnológico.Mostrar detalhesOcultar detalhes
Requisitos de Implantação e Infraestrutura: Read the DocsDockerEspecificações de hardware e diretiva Docker para executar em servidores locais, VPS dedicado ou Kubernetes sem vazamento de telemetria.Mostrar detalhesOcultar detalhes
Comunidade e RepositórioMostrar detalhesOcultar detalhes
Reputação Técnica de Read the Docs
Elogios Frequentes em Produção
- Suporte nativo para múltiplas versões de documentação vinculadas a branches ou tags do Git.
- Pré-visualizações automáticas de documentação geradas em cada pull request.
- Hospedagem gratuita permanente garantida para projetos de código aberto e comunitários.
Fricções Reportadas em Produção
- Dependência de infraestrutura em nuvem que pode sofrer interrupções ocasionais por ataques ou falhas.
- Recursos avançados de controle de acesso e SSO corporativo são restritos aos planos comerciais pagos.
Perguntas Frequentes Técnicas (Read the Docs)
É realmente gratuito para projetos de código aberto?
Sim, o Read the Docs oferece hospedagem totalmente gratuita e por tempo indeterminado para projetos de código aberto qualificados.
Quais geradores de documentação são suportados?
A plataforma suporta nativamente geradores padrão da indústria como Sphinx e MkDocs, compilando projetos escritos em Markdown ou reStructuredText.
Como funcionam as pré-visualizações de pull requests?
Sempre que um pull request é aberto no repositório conectado, o sistema compila automaticamente uma versão temporária de visualização com link de acesso.
