2.5.3, merge website and apidocs actions

Author: rmosolgo

Diff for: .github/workflows/apidocs.yaml

@@ -6,10 +6,19 @@ on:
     tags:
       - 'v*' # Push events to matching v*, i.e. v1.0, v20.15.10
   workflow_dispatch:
+    inputs:
+      publish_website:
+        description: "Publish guides to website?"
+        type: boolean
+        required: true
+      publish_version:
+        description: "If present, pull this GraphQL-Ruby version to rebuild API docs"
+        required: false
+        type: string
 
 permissions: {}
 jobs:
-  build:
+  website:
     permissions:
       contents: write # for git push (s0/git-publish-subdir-action)
     name: Publish Website
@@ -43,3 +52,41 @@ jobs:
           BRANCH: gh-pages
           FOLDER: gh-pages
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+  api_docs:
+    needs: website
+    if: ${{ inputs.publish_version || github.action_ref }}
+    permissions:
+      contents: write # for git push (s0/git-publish-subdir-action)
+    name: Publish API Docs
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout release tag
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ env.GITHUB_REF }}
+      - name: Checkout GitHub pages branch
+        uses: actions/checkout@v4
+        with:
+          path: gh-pages
+          ref: gh-pages
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.2'
+          bundler-cache: true
+      - name: Build API docs
+        run: |
+          bundle exec rake site:fetch_latest apidocs:gen_version["${{ inputs.publish_version || env.GITHUB_REF }}"]
+      - name: Commit changes as last committer
+        run: |
+          git config --global user.name rmosolgo
+          git config --global user.email [email protected]
+          git status
+          bundle exec rake site:commit_changes
+          git status
+      - name: Deploy to GitHub pages via gh-pages branch
+        uses: s0/git-publish-subdir-action@master
+        env:
+          REPO: self
+          BRANCH: gh-pages
+          FOLDER: gh-pages
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Diff for: .github/workflows/website.yaml

@@ -10,6 +10,21 @@
 
 ### Bug fixes
 
+# 2.5.3
+
+### Deprecations
+
+- Validation: two non-spec behaviors are deprecated:
+  - When a query includes two scalar fields of different types which may occur in the same place in the response, the query was previously allowed. The spec says it should be rejected. This version emits a warning in this case. See `Schema.allow_legacy_invalid_return_type_conflicts` for migration support. #4351
+  - When a query selects a field which returns a Union, but doesn't make any subselections on the Union, the spec says the query should be rejected as invalid but previous GraphQL-Ruby allowed it. It now emits a warning. See `Schema.allow_legacy_invalid_empty_selections_on_union` for migration support #5322
+- Complexity: several bugs about merging complexity cost across branches of a query have been fixed but require opting in. They may produce higher complexity scores. See `Schema.complexity_cost_calculation_mode` for migration support. #4843
+
+### New features
+
+- `AlwaysVisible`: improve speed (using `Schema::Visibility`) #5326
+- Return more descriptive errors when non-nullable list elements are `null` #5301
+- Visibility: improve performance on large schemas #5325
+
 # 2.5.2
 
 ### New features

Diff for: CHANGELOG.md

@@ -1,4 +1,4 @@
 # frozen_string_literal: true
 module GraphQL
-  VERSION = "2.5.2"
+  VERSION = "2.5.3"
 end