Docusaurus versions 1.1.0

.github/workflows/cron.yml

@@ -43,6 +43,8 @@ jobs:
   deploy-test-pypi:
 
     runs-on: ubuntu-latest
+    permissions:
+      id-token: write # This is required for PyPI OIDC authentication.
     env:
       # `uv pip ...` requires venv by default. This skips that requirement.
       UV_SYSTEM_PYTHON: 1
@@ -73,8 +75,6 @@ jobs:
     - name: Deploy to Test PyPI
       uses: pypa/gh-action-pypi-publish@release/v1
       with:
-        user: __token__
-        password: ${{ secrets.TEST_PYPI_TOKEN }}
         repository-url: https://test.pypi.org/legacy/
         skip-existing: true
         verbose: true

.github/workflows/deploy.yml

@@ -22,39 +22,8 @@ jobs:
       pinned_botorch: true
     secrets: inherit
 
-  check-versions:
-    needs: tests-and-coverage-pinned
-    name: Check if major or minor version changed
-    runs-on: ubuntu-latest
-    outputs:
-      major_minor_changed: ${{ steps.compare.outputs.major_minor_changed }}
-    steps:
-    - uses: actions/checkout@v4
-      with:
-        fetch-depth: 0
-        fetch-tags: true
-        ref: ${{ github.sha }}
-    - name: Check if major or minor version changed
-      id: compare
-      run: |
-        git fetch --tags --force
-        previous_version=$(git describe --tags --abbrev=0 ${{ github.event.release.tag_name }}^)
-        prev=$(cut -d '.' -f 1-2 <<< $previous_version) # remove patch number
-        prev=${prev#v}                                  # remove optional "v" prefix
-        next=$(cut -d '.' -f 1-2 <<< ${{ github.event.release.tag_name }})
-        next=${next#v}
-
-        echo "Updating from version $previous_version to ${{ github.event.release.tag_name }}"
-        if [[ "$prev" == "$next" ]]; then
-          echo "::warning::Major/Minor version was not changed. Skipping website & docs generation step."
-        else
-          echo major_minor_changed=true >> $GITHUB_OUTPUT
-        fi
-
   version-and-publish-website:
-    needs: check-versions
     name: Version and Publish website
-    if: ${{ needs.check-versions.outputs.major_minor_changed == 'true' }}
     uses: ./.github/workflows/publish_website.yml
     with:
       new_version: ${{ github.event.release.tag_name }}

.github/workflows/publish_website.yml

@@ -13,6 +13,10 @@ on:
       pinned_botorch:
         required: true
         type: boolean
+      dry_run:
+        required: false
+        type: boolean
+        default: false
   workflow_dispatch:
     inputs:
       run_tutorials:
@@ -21,9 +25,12 @@ on:
       pinned_botorch:
         required: true
         type: boolean
+      dry_run:
+        required: true
+        type: boolean
+        default: false
 
 jobs:
-
   build-website:
     runs-on: ubuntu-latest
     permissions:
@@ -68,7 +75,28 @@ jobs:
       name: Run Tutorials
       run: |
         python scripts/run_tutorials.py -w $(pwd)
-    - if: ${{ inputs.new_version }}
+    - if: ${{ inputs.new_version && !inputs.dry_run }}
+      name: Delete existing similar versions from Docusaurus
+      run: |
+        # Delete existing versions for same Major and Minor version numbers.
+        # We do this to keep only the latest patch for a given major/minor version.
+        MAJOR_MINOR_VERSION=$(cut -d '.' -f 1-2 <<< ${{ inputs.new_version }}) # remove patch number
+        MAJOR_MINOR_VERSION=${MAJOR_MINOR_VERSION#v}                           # remove optional "v" prefix
+        for dir in website/versioned_docs/version-$MAJOR_MINOR_VERSION.*; do
+            if [ -d "$dir" ]; then
+                OLD_VERSION=$(basename "$dir" | sed 's/^version-//') # remove "version-" prefix from the directory name
+                echo "Deleting older version $OLD_VERSION with the same major and minor version numbers as $NEW_VERSION"
+                # Delete version from the three locations Docusaurus uses:
+                #   - versioned_docs/version-X.Y.Z/
+                #   - versioned_sidebars/version-X.Y.Z-sidebars.json
+                #   - versions.json
+                # https://docusaurus.io/docs/versioning#deleting-an-existing-version
+                rm -rf "$dir"
+                rm "website/versioned_sidebars/version-$OLD_VERSION-sidebars.json"
+                sed -i "/\"$OLD_VERSION\"/d" website/versions.json
+            fi
+        done
+    - if: ${{ inputs.new_version && !inputs.dry_run }}
       name: Create new docusaurus version
       run: |
         python3 scripts/convert_ipynb_to_mdx.py --clean
@@ -89,6 +117,7 @@ jobs:
         path: website/build/
 
   deploy-website:
+    if: ${{ !inputs.dry_run }}
     needs: build-website
     permissions:
       pages: write

.github/workflows/test_website.yml

@@ -0,0 +1,22 @@
+name: Test Website
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+    paths:
+      - "tutorials/**"
+      - "docs/**"
+      - "scripts/**"
+      - "website/**"
+  workflow_dispatch:
+
+jobs:
+  website:
+    name: Test building website
+    uses: ./.github/workflows/publish_website.yml
+    with:
+      dry_run: true
+      pinned_botorch: false
+      run_tutorials: false

CHANGELOG.md

@@ -1 +1,28 @@
-Ax uses GitHub tags for managing releases. See changelog [here](https://github.com/facebook/Ax/releases).
+# Changelog
+
+The release log for Ax.
+
+## [1.1.0] -- Aug 11, 2025
+#### New Features
+* New option for the `method` parameter in `client.configure_generation_strategy`:
+    `quality` -- allows uers to indicate they would like Ax to generate the highest
+    quality candidates it is able to at the expense of slower runtime (#4042)
+* New logic for deciding which analyses to produce by default in
+    `client.compute_analyses` (#4013)
+* New parameters in `client.summarize` allow users to filter their summary by trial
+    index and/or trial status (#4012, #4118)
+
+#### Bug Fixes
+* Allow `client.summarize` to be called without a `GenerationStrategy` being set
+    (i.e. before `client.configure_generation_strategy` or `client.get_next_trails`
+    has been called.) (#3801)
+* Fixed incorrect grouping in `TopSurfacesAnalysis` (#4095)
+* Fixed `ContourPlot` failing to compute in certain search spaces with parameter
+    constraints (#4124)
+* Misc. plotting fixes and improvements
+
+#### Other changes
+* Bumped pinned [botorch](https://github.com/pytorch/botorch) version to 0.15.1
+* Performance improvements in `SensitivityAnalysis` (#3891)
+* Improved optimization performance in constrained optimization settings (#3585)
+* Augmented logging in `Client`, early stopping module (#4044, #4108)

CONTRIBUTING.md

@@ -77,33 +77,8 @@ We use [Pyre](https://pyre-check.org/) for static type checking and require code
 
 ## Website
 
-The Ax website was created with [Docusaurus](https://docusaurus.io/), with heavy customization to support tutorials, complete API documentation via Sphinx, and versioning.
+The Ax website was created with [Docusaurus](https://docusaurus.io/), with some customization to support tutorials, and supplemented with Sphinx for API documentation. See the [website/README.md](website/README.md) for more details.
 
-FontAwesome icons were used under the [Creative Commons Attribution 4.0 International](https://fontawesome.com/license).
-
-### Local Building
-
-You will need [Node](https://nodejs.org/en/) >= 8.x and [Yarn](https://yarnpkg.com/en/) >= 1.5
-to build the Sphinx docs and Docusaurus site (which embeds the Sphinx docs inside). The
-following command will both build the docs and serve the (unversioned) site locally:
-```
-./scripts/make_docs.sh
-```
-
-Open http://localhost:3000 (if doesn't automatically open). Anytime you change the contents of the page, the page should auto-update.
-
-To build a static version, add the `-b` flag.
-
-Additional details:
-
-* This is the unversioned site built off of the current repository. Versioning is much more complex, and is generally not necessary for testing the site. Versioning is automatically handled when publishing the site to `gh-pages`.
-* Skipping Sphinx API & tutorials: to build the site without running Sphinx or compiling the tutorials, pass the `-o` flag to the `make_docs.sh` script. This is especially useful when you want to iterate quickly on making changes to the Docusaurus config and you've already run Sphinx and tutorial generation (the outputs are still in `website` subdirectory and will be picked up).
-* Tutorials: we embed tutorials written in Jupyter notebooks into the site. By default, these tutorials are converted to HTML without execution. However, you can execute all tutorials via `./scripts/make_docs.sh -t`. If you do execute the tutorials, please keep in mind that the version of Ax you have installed should match the version of Ax you're trying to build tutorials for.
-
-### Publishing
-The site is hosted as a GitHub page (on the `gh-pages` branch). We build the [latest version](https://ax.dev/versions/latest/index.html) of the site with every commit to the `main` branch via GitHub Actions. The latest version of the site can be manually updated using `./scripts/publish_site.sh` (assuming proper credentials).
-
-When new version of Ax rolls out, we add a new version to the site via `./scripts/publish_site.sh -v [version]`.
 
 ## License
 By contributing to Ax, you agree that your contributions will be licensed

ax/modelbridge/__init__.py → ax/adapter/__init__.py

@@ -7,16 +7,11 @@
 # pyre-strict
 
 # flake8: noqa F401
-from ax.modelbridge import transforms
-from ax.modelbridge.base import Adapter
-from ax.modelbridge.factory import (
-    Generators,
-    get_factorial,
-    get_sobol,
-    get_thompson,
-    get_uniform,
-)
-from ax.modelbridge.torch import TorchAdapter
+from ax.adapter import transforms
+from ax.adapter.base import Adapter
+from ax.adapter.factory import get_factorial, get_sobol, get_thompson
+from ax.adapter.registry import Generators
+from ax.adapter.torch import TorchAdapter
 
 __all__ = [
     "Adapter",
@@ -25,6 +20,5 @@
     "get_factorial",
     "get_sobol",
     "get_thompson",
-    "get_uniform",
     "transforms",
 ]