DOC: use nightly dependencies [skip actions] [azp skip] [skip travis] (…

…numpy#24346)

[skip actions] [skip cirrus] [skip travis] [skip azp]

.circleci/config.yml

@@ -8,12 +8,8 @@ version: 2.1
 _defaults: &defaults
   docker:
     # CircleCI maintains a library of pre-built images
-    # documented at https://circleci.com/docs/2.1/circleci-images/
-    # circleci/python3.8 images come with old versions of Doxygen(1.6.x),
-    # therefore a new base image chose instead to guarantee to
-    # have a newer version >= 1.8.10 to avoid warnings
-    # that related to the default behaviors or non-exist config options
-    - image: cimg/python:3.9
+    # documented at https://circleci.com/developer/images/image/cimg/python
+    - image: cimg/python:3.11.4
   working_directory: ~/repo
 
 
@@ -54,15 +50,17 @@ jobs:
             #sudo apt-get install -y python3.9 python3.9-dev python3-venv graphviz texlive-fonts-recommended texlive-latex-recommended \
             sudo apt-get install -y graphviz texlive-fonts-recommended texlive-latex-recommended \
               texlive-latex-extra latexmk texlive-xetex texlive-lang-chinese doxygen
-            python3.9 -m venv venv
+            python3.11 -m venv venv
             . venv/bin/activate
 
       - run:
           name: build numpy
           command: |
             . venv/bin/activate
             pip install --progress-bar=off -r test_requirements.txt
-            pip install --progress-bar=off -r doc_requirements.txt
+            # get newer, pre-release versions of critical packages
+            pip install --progress-bar=off --pre --extra-index-url https://pypi.anaconda.org/scientific-python-nightly-wheels/simple -r doc_requirements.txt
+            # then install numpy HEAD, which will override the version installed above
             pip install . --config-settings=setup-args="-Dallow-noblas=true"
 
       - run:

doc/source/dev/development_workflow.rst

@@ -196,8 +196,8 @@ from running the test suite on different operating systems and hardware
 platforms to building the docs. In some cases you already know that CI isn't
 needed (or not all of it), for example if you work on CI config files, text in
 the README, or other files that aren't involved in regular build, test or docs
-sequences. In such cases you may explicitly skip CI by including one of these
-fragments in your commit message:
+sequences. In such cases you may explicitly skip CI by including one or more of
+these fragments in each commit message of a PR:
 
 * ``[skip ci]``: skip all CI
 

doc/source/user/basics.indexing.rst

@@ -785,7 +785,7 @@ exceptions (assigning complex to floats or ints): ::
  >>> x[1] = 1.2
  >>> x[1]
  1
- >>> x[1] = 1.2j
+ >>> x[1] = 1.2j  # doctest: +IGNORE_EXCEPTION_DETAIL
  Traceback (most recent call last):
    ...
  TypeError: can't convert complex to int