Sonar helps you commit clean code every time. With over 225 unique rules to find Python bugs, code smells & vulnerabilities, Sonar finds the issues while you focus on the work. Learn more →
Top 14 Python documentation-tool Projects
-
So, I've documented my code and now I need a .PDF with this documentation. Is there any easy way to do it? Once I used Sphinx but it generated a not so easy .TeX.
-
Project mention: what's a good documentation platform that you guys would recommend? | /r/Python | 2022-08-16
I’ve used sphinx extensively and though it is one of the standards and does a ton, I do not like or recommend it. Personally, I realllly like pdoc for its simplicity. Do not confused pdoc with pdoc3
-
InfluxDB
Access the most powerful time series database as a service. Ingest, store, & analyze all types of time series data in a fully-managed, purpose-built database. Keep data forever with low-cost storage and superior data compression.
-
Project mention: Tools that help to explore and navigate database tables | /r/dataengineering | 2022-11-21
sometging like this, maybe https://github.com/Alexis-benoist/eralchemy
-
Project mention: Asian faiths try to save swastika symbol corrupted by Hitler | news.ycombinator.com | 2022-11-27
Also seen in GitHub in the wild at times. Always brings interesting discussions...
https://github.com/pdoc3/pdoc/issues/87
I've learnt a lot about cultures through those PRs
-
-
-
I use MkDocs for generating the documentation website (using the Material theme) and host in on GitHub pages. For managing and hosting multiple versions, I use the Mike extension for MkDocs.
-
Sonar
Write Clean Python Code. Always.. Sonar helps you commit clean code every time. With over 225 unique rules to find Python bugs, code smells & vulnerabilities, Sonar finds the issues while you focus on the work.
-
AutoDoc-ChatGPT
AutoDoc-ChatGPT is a Python script that leverages the power of ChatGPT model to automatically generate documentation for any programming language. With AutoDoc-ChatGPT, you can easily generate comprehensive documentation for your codebase.
I have been using AutoDoc-ChatGPT (https://github.com/awekrx/AutoDoc-ChatGPT) to document python code. For this I need to use either command line or paste the code to be documented in another script, which can get a bit troublesome.
-
-
-
-
hitchstory
Type-safe YAML integration tests. Tests that write your docs. Tests that rewrite themselves.
Project mention: Ask HN: BDD and Gherkin tests, do they provide value in the real world? | news.ycombinator.com | 2023-06-08I like the idea a lot but I felt that the Gherkin language itself was inappropriate for the task for four main reasons:
* Verbosity
* Not type safe
* It doesnt have story abstractions (i.e. you can't flexibly create variations on a story).
* The use of regexes for parsing
I created a YAML based alternative with python that I think has all of the benefits and fixes those 4 problems: https://hitchdev.com/hitchstory
-
sphinxcontrib-hdl-diagrams
Sphinx Extension which generates various types of diagrams from Verilog code.
-
Project mention: I’m a Productive Programmer with a Memory of a Fruit Fly | news.ycombinator.com | 2022-09-19
-
SaaSHub
SaaSHub - Software Alternatives and Reviews. SaaSHub helps you find the best software and product alternatives
Python documentation-tool related posts
- Generate PDF from file (docstrings)
- dictf - An extended Python dict implementation that supports multiple key selection with a pretty syntax.
- Pipeline documentation
- Minimum Viable Hugo – No CSS, no JavaScript, 1 static HTML page to start you off
- Ruff: An fast Python linter, written in Rust
- where do you host your embedded docs?
- Why Is Markdown Popular?
-
A note from our sponsor - Sonar
www.sonarsource.com | 10 Jun 2023
Index
What are some of the best open-source documentation-tool projects in Python? This list will help you:
Project | Stars | |
---|---|---|
1 | sphinx | 5,464 |
2 | pdoc | 1,550 |
3 | eralchemy | 1,017 |
4 | pdoc | 971 |
5 | pydoc-markdown | 405 |
6 | ford | 355 |
7 | mike | 334 |
8 | AutoDoc-ChatGPT | 295 |
9 | nbdev_template | 269 |
10 | gdscript-docs-maker | 203 |
11 | strictdoc | 92 |
12 | hitchstory | 44 |
13 | sphinxcontrib-hdl-diagrams | 39 |
14 | qe-docset | 5 |