DOC Improve the documentation home page (#1958)

* DOC Improve the documentation home page [skip CI]

* Link to the blog [skip ci]

* Apply suggestions from code review [skip ci]

Co-authored-by: Jan Max Meyer <jmm@phorward.de>

README.md

@@ -73,6 +73,7 @@ governance](https://pyodide.org/en/stable/project/governance.html).
 
 ## Communication
 
+- Blog: [blog.pyodide.org](https://blog.pyodide.org/)
 - Mailing list: [mail.python.org/mailman3/lists/pyodide.python.org/](https://mail.python.org/mailman3/lists/pyodide.python.org/)
 - Gitter: [gitter.im/pyodide/community](https://gitter.im/pyodide/community)
 - Twitter: [twitter.com/pyodide](https://twitter.com/pyodide)

docs/index.rst

@@ -6,19 +6,33 @@ Python with the scientific stack, compiled to WebAssembly.
 Pyodide may be used in any context where you want to run Python inside a web
 browser.
 
-Pyodide brings the Python 3.9 runtime to the browser via WebAssembly, along
-with the Python scientific stack including NumPy, Pandas, Matplotlib, SciPy, and
-scikit-learn. Over 75 packages are currently available. In addition it's
+Pyodide brings the Python 3.9 runtime to the browser via WebAssembly, thanks to
+`Emscripten <https://emscripten.org/>`_.
+It builds the Python scientific stack including NumPy, Pandas, Matplotlib, SciPy, and
+scikit-learn. Over 75 packages are currently available. In addition, it's
 possible to install pure Python wheels from PyPI.
 
 Pyodide provides transparent conversion of objects between JavaScript and
 Python. When used inside a browser, Python has full access to the Web APIs.
 
+Pyodide development happens on GitHub: `github.com/pyodide/pyodide <https://github.com/pyodide/pyodide>`_
+
+Try Pyodide (no installation needed)
+------------------------------------
+
+Try Pyodide in a
+`REPL <https://pyodide.org/en/stable/console.html>`_ directly in
+your browser.
+
+
+Table of contents
+-----------------
+
 Using Pyodide
-=============
+^^^^^^^^^^^^^
 
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
 
    usage/quickstart.md
    usage/downloading-and-deploying.md
@@ -31,11 +45,10 @@ Using Pyodide
    usage/faq.md
 
 Development
-===========
+^^^^^^^^^^^
 
 The Development section help Pyodide contributors to find information about the
-development process including making packages to support third party libraries
-and understanding type conversions between Python and JavaScript.
+development process including making packages to support third party libraries.
 
 .. toctree::
    :maxdepth: 1
@@ -49,10 +62,10 @@ and understanding type conversions between Python and JavaScript.
 
 
 Project
-=======
+^^^^^^^
 
-The Project section helps contributors get started and gives additional
-information about the project's organization.
+The Project section gives additional information about the project's
+organization and latest releases.
 
 .. toctree::
    :maxdepth: 1
@@ -65,9 +78,12 @@ information about the project's organization.
    project/changelog.md
    project/related-projects.md
 
-Indices and tables
-==================
 
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`
+Communication
+-------------
+
+- Blog: `blog.pyodide.org <https://blog.pyodide.org/>`_
+- Mailing list: `mail.python.org/mailman3/lists/pyodide.python.org/ <https://mail.python.org/mailman3/lists/pyodide.python.org/>`_
+- Gitter: `gitter.im/pyodide/community <https://gitter.im/pyodide/community>`_
+- Twitter: `twitter.com/pyodide <https://twitter.com/pyodide>`_
+- Stack Overflow: `stackoverflow.com/questions/tagged/pyodide <https://stackoverflow.com/questions/tagged/pyodide>`_

docs/project/about.md

@@ -53,6 +53,7 @@ list from there with "The Pyodide development team" like in the example below:
 
 ## Communication
 
+- Blog: [blog.pyodide.org](https://blog.pyodide.org/)
 - Mailing list: [mail.python.org/mailman3/lists/pyodide.python.org/](https://mail.python.org/mailman3/lists/pyodide.python.org/)
 - Gitter: [gitter.im/pyodide/community](https://gitter.im/pyodide/community)
 - Twitter: [twitter.com/pyodide](https://twitter.com/pyodide)