Prepare release 2.5.0 (#535)

* Bump version 2.5.0

* Avoid user warning in examples

* Fix doc conf warnings

* Fix error in doc generation

* Doc format

* Configure to avoid warnings: stub file not found

* Fix doc generation warnings

* Fix __all__

* Fix references usage

* Fix typo

* Update build release

.github/workflows/build_release.yml

@@ -11,13 +11,13 @@ jobs:
  runs-on: ${{ matrix.os }}
  strategy:
  matrix:
- os: [ubuntu-22.04, windows-2022, macos-11]
+ os: [ubuntu-latest, windows-latest, macos-latest]
 
  steps:
  - uses: actions/checkout@v4
 
  - name: Build wheels
- uses: pypa/cibuildwheel@v2.16.5
+ uses: pypa/cibuildwheel@v2.17.0
  env:
  CIBW_BUILD: cp38-* cp39-* cp310-* cp311-*
  CIBW_SKIP: cp*_i686