3rd attempt at 8.0.0a1

.github/workflows/docs.yml

@@ -1,35 +1,36 b''
 name: Build docs
 
 on: [push, pull_request]
 
 jobs:
   build:
     runs-on: ubuntu-latest
 
     steps:
     - uses: actions/checkout@v2
     - name: Set up Python 3.8
       uses: actions/setup-python@v2
       with:
         python-version: 3.8
     - name: Install Graphviz
       run: |
         sudo apt-get update
         sudo apt-get install graphviz
     - name: Install Python dependencies
       run: |
-        python -m pip install --upgrade pip setuptools coverage
+        python -m pip install --upgrade pip setuptools coverage rstvalidator
         pip install -r docs/requirements.txt
     - name: Build docs
       run: |
+        python -m rstvalidator long_description.rst
         python tools/fixup_whats_new_pr.py
         make -C docs/ html SPHINXOPTS="-W" \
           PYTHON="coverage run -a" \
           SPHINXBUILD="coverage run -a -m sphinx.cmd.build"
     - name: Generate coverage xml
       run: |
         coverage combine `find . -name .coverage\*` && coverage xml
     - name: Upload coverage to Codecov
       uses: codecov/codecov-action@v2
       with:
         name: Docs

long_description.rst

@@ -1,37 +1,37 b''
 IPython provides a rich toolkit to help you make the most out of using Python
 interactively.  Its main components are:
 
-* A powerful interactive Python shell
-* A `Jupyter <https://jupyter.org/>`_ kernel to work with Python code in Jupyter
-notebooks and other interactive frontends.
+ * A powerful interactive Python shell
+ * A `Jupyter <https://jupyter.org/>`_ kernel to work with Python code in Jupyter
+   notebooks and other interactive frontends.
 
 The enhanced interactive Python shells have the following main features:
 
-* Comprehensive object introspection.
+ * Comprehensive object introspection.
 
-* Input history, persistent across sessions.
+ * Input history, persistent across sessions.
 
-* Caching of output results during a session with automatically generated
-references.
+ * Caching of output results during a session with automatically generated
+   references.
 
-* Extensible tab completion, with support by default for completion of python
-variables and keywords, filenames and function keywords.
+ * Extensible tab completion, with support by default for completion of python
+   variables and keywords, filenames and function keywords.
 
-* Extensible system of 'magic' commands for controlling the environment and
-performing many tasks related either to IPython or the operating system.
+ * Extensible system of 'magic' commands for controlling the environment and
+   performing many tasks related either to IPython or the operating system.
 
-* A rich configuration system with easy switching between different setups
-(simpler than changing $PYTHONSTARTUP environment variables every time).
+ * A rich configuration system with easy switching between different setups
+   (simpler than changing $PYTHONSTARTUP environment variables every time).
 
-* Session logging and reloading.
+ * Session logging and reloading.
 
-* Extensible syntax processing for special purpose situations.
+ * Extensible syntax processing for special purpose situations.
 
-* Access to the system shell with user-extensible alias system.
+ * Access to the system shell with user-extensible alias system.
 
-* Easily embeddable in other Python programs and GUIs.
+ * Easily embeddable in other Python programs and GUIs.
 
-* Integrated access to the pdb debugger and the Python profiler.
+ * Integrated access to the pdb debugger and the Python profiler.
 
 The latest development version is always available from IPython's `GitHub
 site <http://github.com/ipython>`_.