create start page

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