pdoc vs Theneo

pdoc generates API documentation from Python projects and organizes it around each project's module hierarchy. Its setup documentation says no configuration is needed to begin. The tool produces standalone HTML that can be exported to files, and a built-in web server refreshes the documentation when source files change. It supports Python type annotations and recognizes Markdown, numpydoc, and Google-style docstrings, with limited reStructuredText support. Developers can customize the generated HTML templates; search runs in the browser without third-party services. Deployment guidance covers GitHub Pages, and custom HTML fragments can be embedded in content management systems or static site generators. pdoc also offers a high-level interface and can be used as a Python library. It is free and open source, compatible with Python 3.10 and newer, and available for Linux, macOS, Windows, web, and self-hosted use. HTML is its only output format, and API documentation is its principal use case. Since pdoc imports or executes the Python modules while extracting docstrings, those modules are executed during documentation generation; Sphinx is recommended for substantially more complex documentation needs.

Theneo is a developer portal for publishing API references, guides, changelogs, and customer-specific private portals. It creates interactive API documentation from OpenAPI files, Postman collections, or Git connections, with code samples, live testing, and CI/CD sync. Supported formats include REST, AsyncAPI, SOAP, GraphQL, and gRPC. Teams can co-edit, comment, review changes, track versions, and roll back. AI tools include documentation generation, Ask AI answers, release summaries, MCP, and llms.txt support. Private portals can control API visibility by customer and include SSO options and custom branding. Integrations include GitHub and Bitbucket sync, a VS Code extension, Postman sync, CLI, SDK, and API access. Theneo lists SOC 2 Type II, ISO 27001, and ISO 9001 certifications and GDPR compliance; it describes AES-256 encryption at rest, TLS 1.2 or later in transit, and seven-day point-in-time backups. A free plan is available; Business starts at $120/month billed annually. Enterprise includes self-hosting on AWS, Azure, Google Cloud, or on-premises Kubernetes.