Merge branch 'master' into copilot/fix-983-2

Author: thomasht86

.github/copilot-instructions.md

@@ -108,13 +108,14 @@ app_package.schema.add_fields(
 
 ## Documentation source
 
-Very often you need to consult the Vespa documentation. For example for format of the XML configuration files, or for documentation of a specific query parameter, and so on. Find relevant info using the context7 MCP server that you have available. (repo: vespa-engine/documentation)
+Very often you need to consult the Vespa documentation. For example for format of the XML configuration files, or for documentation of a specific query parameter, and so on. Find relevant info using the context7 MCP server that you have available. (repo: vespa-engine/documentation).
 
+You can also use context7 MCP server to search documentation of other libraries used in the project, such as `httpx`, `requests`, `docker`, etc.
 
 ## Development Workflow
 
 We use `uv` for managing dependencies.
-To install the project with development dependencies, run:
+You already have the project set up with development dependencies, run:
 ```bash
 uv sync --extra dev
 ``` 
@@ -123,4 +124,11 @@ After that you can run tests with:
 ```bash
 uv run pytest tests/unit/ -v
 ```
-You can also replace `unit`with `integration` to run integration tests, or just `tests/` to run all tests, or run specific test files or test cases the same way.
+You can also replace `unit` with `integration` to run integration tests, or just `tests/` to run all tests, or run specific test files or test cases the same way.
+
+Doctests: 
+You can run doctests in the examples and documentation with:
+```bash
+uv sync --extra dev --extra docs
+uv run pytest tests/mktestdocs -s -v
+```

.github/workflows/copilot-setup-steps.yml

@@ -0,0 +1,39 @@
+name: "Copilot Setup Steps"
+
+# Automatically run the setup steps when they are changed to allow for easy validation, and
+# allow manual testing through the repository's "Actions" tab
+on:
+  workflow_dispatch:
+  push:
+    paths:
+      - .github/workflows/copilot-setup-steps.yml
+  pull_request:
+    paths:
+      - .github/workflows/copilot-setup-steps.yml
+
+jobs:
+  # The job MUST be called `copilot-setup-steps` or it will not be picked up by Copilot.
+  copilot-setup-steps:
+    runs-on: ubuntu-latest
+
+    # Set the permissions to the lowest permissions possible needed for your steps.
+    # Copilot will be given its own token for its operations.
+    permissions:
+      # If you want to clone the repository as part of your setup steps, for example to install dependencies, you'll need the `contents: read` permission. If you don't clone the repository in your setup steps, Copilot will do this for you automatically after the steps complete.
+      contents: read
+
+    # You can define any steps you want, and they will run before the agent starts.
+    # If you do not check out your code, Copilot will do this for you.
+    steps:
+      - name: Install pandoc
+        run: |
+          sudo apt-get install -y pandoc
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@f0ec1fc3b38f5e7cd731bb6ce540c5af426746bb # v6
+        with:
+          python-version: "3.10"
+
+      - name: Install dependencies
+        run: |
+          uv sync --extra dev