Merge branch 'master' into chore/update-general-resource-access-docs

Author: raethlo

.github/styles/config/vocabularies/Docs/accept.txt

@@ -119,7 +119,7 @@ subreddits?
 [Ss]ubwoofer
 Tripadvisor
 upvote
-walkthroughs?
+[Ww]alkthroughs?
 
 ul
 [Aa]gno

.github/workflows/nginx.conf-test.yaml

@@ -35,6 +35,66 @@ jobs:
                     INTERCOM_APP_ID: ${{ secrets.INTERCOM_APP_ID }}
                     SEGMENT_TOKEN: ${{ secrets.SEGMENT_TOKEN }}
 
+            -   name: Install Nginx
+                run: |
+                    sudo apt-get update
+                    sudo apt-get install -y nginx
+
+            -   name: Start Docusaurus server
+                run: |
+                    nohup npx docusaurus serve --port 3000 --no-open &
+                    sleep 5
+                    curl -f http://localhost:3000 > /dev/null
+
+            -   name: Start Nginx with project config
+                run: |
+                    cat > default.conf <<EOF
+                    worker_processes auto;
+                    error_log $(pwd)/logs/error.log;
+                    pid $(pwd)/logs/nginx.pid;
+                    events {}
+                    http {
+                        access_log $(pwd)/logs/access.log;
+                        include $(pwd)/nginx.conf;
+                    }
+                    EOF
+                    sed -i 's|https://apify.github.io/apify-docs|http://localhost:3000|g' default.conf
+                    mkdir -p $(pwd)/logs
+                    nginx -c $(pwd)/default.conf
+                    sleep 1
+
+            -   name: Run header assertions
+                run: |
+                    set -euo pipefail
+                    function assert_header() {
+                        url=$1
+                        header=$2
+                        expected=$3
+                        shift 3
+                        extra_args=("$@")
+                        actual=$(curl -s -D - -o /dev/null "${extra_args[@]}" "$url" | grep -i "^$header" | tr -d '\r' || true)
+                        echo "→ $url → $actual"
+                        echo "$actual" | grep -q "$expected" || (echo "❌ Expected '$expected' in '$header' for $url" && exit 1)
+                    }
+
+                    echo "🧪 Checking Nginx responses..."
+
+                    assert_header "http://localhost:8080/" "Content-Type" "text/html"
+                    assert_header "http://localhost:8080/" "Content-Type" "text/markdown" -H "Accept: text/markdown"
+                    assert_header "http://localhost:8080/platform/proxy/usage" "Content-Type" "text/html"
+                    assert_header "http://localhost:8080/platform/proxy/usage.md" "Content-Type" "text/markdown"
+                    assert_header "http://localhost:8080/platform/proxy/usage" "Content-Type" "text/markdown" -H "Accept: text/markdown"
+                    assert_header "http://localhost:8080/img/docs-og.png" "Content-Type" "image/png"
+                    assert_header "http://localhost:8080/img/javascript-40x40.svg" "Content-Type" "image/svg"
+                    assert_header "http://localhost:8080/llms.txt" "Content-Type" "text/markdown"
+                    assert_header "http://localhost:8080/llms-full.txt" "Content-Type" "text/markdown"
+
+                    echo "✅ All Nginx header checks passed."
+
+            -   name: Stop Nginx
+                if: always()
+                run: nginx -c $(pwd)/default.conf -s stop
+
     lint_content:
         name: Lint markdown content
         runs-on: ubuntu-latest

.github/workflows/test.yaml

@@ -70,7 +70,7 @@ This will be enough to work on Platform, Academy and OpenAPI. If you want to wor
 5. Add a record to `/etc/hosts`, which maps the `docs.apify.loc` to a localhost:
 
     ```text
-    127.0.01 docs.apify.loc
+    127.0.0.1 docs.apify.loc
     ```
 
 You should be able to open https://docs.apify.loc in your browser and run all the repositories jointly as one project.

CONTRIBUTING.md

@@ -53,16 +53,48 @@ properties:
   taggedBuilds:
     type: object
     description: |
-      Object containing the Actor's tagged builds, where the key is the tag name (e.g., _latest_) and the value is an object containing the build ID.
-      The object you provide will completely overwrite all existing tagged builds for the Actor.
+      An object to modify tags on the Actor's builds. The key is the tag name (e.g., _latest_), and the value is either an object with a `buildId` or `null`.
 
-      - To create or reassign a tag: Include it in the object with the desired `buildId`.
-      - To remove a specific tag: Submit the object without that tag's key.
-      - To remove all tags: Provide an empty object: `{}`.
-      - If this field is omitted or `null`, the existing tags will not be changed.
+      This operation is a patch; any existing tags that you omit from this object will be preserved.
+
+      - **To create or reassign a tag**, provide the tag name with a `buildId`. e.g., to assign the _latest_ tag:
+
+         
+
+        ```json
+        {
+          "latest": {
+            "buildId": "z2EryhbfhgSyqj6Hn"
+          }
+        }
+        ```
+
+      - **To remove a tag**, provide the tag name with a `null` value. e.g., to remove the _beta_ tag:
+
+         
+
+        ```json
+        {
+          "beta": null
+        }
+        ```
+
+      - **To perform multiple operations**, combine them. The following reassigns _latest_ and removes _beta_, while preserving any other existing tags.
+
+         
+
+        ```json
+        {
+          "latest": {
+            "buildId": "z2EryhbfhgSyqj6Hn"
+          },
+          "beta": null
+        }
+        ```
     nullable: true
     additionalProperties:
       type: object
+      nullable: true
       required:
         - buildId
       properties:
@@ -71,3 +103,4 @@ properties:
     example:
       latest:
         buildId: z2EryhbfhgSyqj6Hn
+      beta: null

apify-api/openapi/components/schemas/actors/UpdateActorRequest.yaml

@@ -133,32 +133,53 @@ put:
       application/json:
         schema:
           $ref: "../../components/schemas/actors/UpdateActorRequest.yaml"
-        example:
-          name: MyActor
-          description: My favourite Actor!
-          isPublic: false
-          seoTitle: My Actor
-          seoDescription: My Actor is the best
-          title: My Actor
-          restartOnError: false
-          versions:
-            - versionNumber: '0.0'
-              sourceType: SOURCE_FILES
-              envVars:
-                - name: DOMAIN
-                  value: 'http://example.com'
-                  isSecret: false
-                - name: SECRET_PASSWORD
-                  value: MyTopSecretPassword123
-                  isSecret: true
-              applyEnvVarsToBuild: false
-              buildTag: latest
-              sourceFiles: []
-          categories: []
-          defaultRunOptions:
-            build: latest
-            timeoutSecs: 3600
-            memoryMbytes: 2048
+        examples:
+          common:
+            summary: 'Common example'
+            value:
+              name: MyActor
+              description: My favourite Actor!
+              isPublic: false
+              seoTitle: My Actor
+              seoDescription: My Actor is the best
+              title: My Actor
+              restartOnError: false
+              versions:
+                - versionNumber: '0.0'
+                  sourceType: SOURCE_FILES
+                  envVars:
+                    - name: DOMAIN
+                      value: 'http://example.com'
+                      isSecret: false
+                    - name: SECRET_PASSWORD
+                      value: MyTopSecretPassword123
+                      isSecret: true
+                  applyEnvVarsToBuild: false
+                  buildTag: latest
+                  sourceFiles: []
+              categories: []
+              defaultRunOptions:
+                build: latest
+                timeoutSecs: 3600
+                memoryMbytes: 2048
+          taggedBuildsCreateOrReassignTag:
+            summary: 'Create or reassign a build tag'
+            value:
+              taggedBuilds:
+                latest:
+                  buildId: 'z2EryhbfhgSyqj6Hn'
+          taggedBuildsRemoveTag:
+            summary: 'Remove a build tag'
+            value:
+              taggedBuilds:
+                latest: null
+          taggedBuildsMultipleOperations:
+            summary: 'Update multiple build tags at once'
+            value:
+              taggedBuilds:
+                latest:
+                  buildId: 'z2EryhbfhgSyqj6Hn'
+                beta: null
     required: true
   responses:
     '200':

apify-api/openapi/paths/actors/acts@{actorId}.yaml

@@ -1,6 +1,6 @@
 {
     "name": "@apify/docs-theme",
-    "version": "1.0.217",
+    "version": "1.0.218",
     "description": "",
     "main": "./src/index.js",
     "files": [

apify-docs-theme/package.json

@@ -2,6 +2,7 @@ import clsx from 'clsx';
 import React, { useCallback, useState } from 'react';
 
 import {
+    AnthropicIcon,
     ChatGptIcon,
     CheckIcon,
     ChevronDownIcon,
@@ -37,6 +38,13 @@ const DROPDOWN_OPTIONS = [
         Icon: ChatGptIcon,
         value: 'openInChatGPT',
     },
+    {
+        label: 'Open in Claude',
+        description: 'Ask questions about this page',
+        showExternalIcon: true,
+        Icon: AnthropicIcon,
+        value: 'openInClaude',
+    },
     {
         label: 'Open in Perplexity',
         description: 'Ask questions about this page',
@@ -70,6 +78,27 @@ const onOpenInChatGPTClick = () => {
     }
 };
 
+const onOpenInClaudeClick = () => {
+    if (window.analytics) {
+        window.analytics.track('Clicked', {
+            app: 'docs',
+            button_text: 'Open in Claude',
+            element: 'llm-buttons.openInClaude',
+        });
+    }
+
+    const prompt = getPrompt(window.location.href);
+
+    try {
+        window.open(
+            `https://claude.ai/new?q=${encodeURIComponent(prompt)}`,
+            '_blank',
+        );
+    } catch (error) {
+        console.error('Error opening Claude:', error);
+    }
+};
+
 const onOpenInPerplexityClick = () => {
     if (window.analytics) {
         window.analytics.track('Clicked', {
@@ -227,6 +256,9 @@ export default function LLMButtons({ isApiReferencePage = false }) {
             case 'openInChatGPT':
                 onOpenInChatGPTClick();
                 break;
+            case 'openInClaude':
+                onOpenInClaudeClick();
+                break;
             case 'openInPerplexity':
                 onOpenInPerplexityClick();
                 break;