summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md13
1 files changed, 11 insertions, 2 deletions
diff --git a/README.md b/README.md
index 987c23d..6f185bf 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,15 @@
-# pydoc.dev - docs.rs for Python
+# pydoc.dev - consistent API docs for Python
-* powered by [pydoctor]
+Looking at the API documentations of Python packages can be a bit disorienting
+because they can look different from project to project (since different
+projects use different [Sphinx] themes) and because the API documentation
+often is not structured after the Python modules.
+**pydoc.dev** strives to be for Python what [docs.rs] is for Rust.
+It works by downloading the source files from the [Python Package Index],
+the API documentation is then generated with [pydoctor].
+[Sphinx]: https://www.sphinx-doc.org/
+[docs.rs]: https://docs.rs/
+[Python Package Index]: https://pypi.org/
[pydoctor]: https://github.com/twisted/pydoctor