Merge branch 'main' into pl-update-islands.mdx

Author: erbierc

.gitpod.yml

@@ -101,8 +101,7 @@ Our Docs are translated into several languages and we rely on automation to noti
 
 **Pages generated from outside sources**
 
-Some of our English-language pages are generated from outside sources and maintained in another repo. Currently, these files are `configuration-reference.md` and all those under the `integrations-guide/` directory as well as our error messages.
-
+Some of our English-language pages are generated from outside sources and maintained in another repo. Currently, these files are configuration-reference.md and all our error messages.
 The page's **Edit this page** button should redirect you to the file that should be changed. Alternatively, you can get the correct URL from the file's `githubURL` frontmatter property.
 
 > **Note**
@@ -123,15 +122,15 @@ Every pull request needs to be reviewed by our contributors and approved by a ma
 
 You can find more information about submitting your pull requests in our [contributor guides](https://contribute.docs.astro.build)
 
-### Contribute PRs using an online code editor (e.g. StackBlitz, Codeflow, CodeSandbox, Gitpod)
+### Contribute PRs using an online code editor (e.g. StackBlitz, Codeflow, CodeSandbox)
 
 Editing a local fork on GitHub.com is convenient for small text changes, but does not allow you to see a live preview of the site.
 
 You can instead open your fork in an online IDE (integrated development environment) for a code editor and live preview without needing to set up any local development environment. Each online IDE has its own shortcut URL for opening an existing repository, and will allow you to create pull requests after you have made changes.
 
-See specific instructions for opening an existing repository in [CodeSandbox](https://codesandbox.io/docs/importing#import-from-github), [StackBlitz](https://developer.stackblitz.com/docs/platform/importing-projects/#import-from-github), [Codeflow IDE](https://developer.stackblitz.com/codeflow/working-in-codeflow-ide) and [Gitpod](https://www.gitpod.io/docs/getting-started#start-your-first-workspace) on their respective websites.
+See specific instructions for opening an existing repository in [CodeSandbox](https://codesandbox.io/docs/importing#import-from-github), [StackBlitz](https://developer.stackblitz.com/docs/platform/importing-projects/#import-from-github) and [Codeflow IDE](https://developer.stackblitz.com/codeflow/working-in-codeflow-ide) on their respective websites.
 
-Note that CodeSandbox and StackBlitz provide Astro syntax highlighting in their custom code editors, while Gitpod and Codeflow support the full [Astro VSCode extension](https://docs.astro.build/en/editor-setup/#vs-code).
+Note that CodeSandbox and StackBlitz provide Astro syntax highlighting in their custom code editors, while Codeflow supports the full [Astro VSCode extension](https://docs.astro.build/en/editor-setup/#vs-code).
 
 ### Contribute PRs by Developing Locally
 

CONTRIBUTING.md

@@ -6,7 +6,6 @@ To all who come to this happy place: welcome.
 This is the repo for [docs.astro.build](https://docs.astro.build/).
 This repo contains all the source code we use to build our docs site.
 
-[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/withastro/docs)
 [![Open with CodeSandbox](https://assets.codesandbox.io/github/button-edit-lime.svg)](https://codesandbox.io/p/github/withastro/docs)
 [![Open in Codeflow](https://developer.stackblitz.com/img/open_in_codeflow.svg)](https://pr.new/github.com/withastro/docs)
 

README.md

@@ -34,6 +34,7 @@ const services: Service[] = [
 	{ title: 'Heroku', slug: 'heroku', supports: ['static'] },
 	{ title: 'Microsoft Azure', slug: 'microsoft-azure', supports: ['static'] },
 	{ title: 'Buddy', slug: 'buddy', supports: ['static'] },
+	{ title: 'DeployHQ', slug: 'deployhq', supports: ['static'] },
 	{ title: 'Fleek', slug: 'fleek', supports: ['static'] },
 	{ title: 'Fly.io', slug: 'flyio', supports: ['ssr', 'static'] },
 	{ title: 'Railway', slug: 'railway', supports: ['ssr', 'static'] },
@@ -46,6 +47,7 @@ const services: Service[] = [
 	{ title: 'Zerops', slug: 'zerops', supports: ['ssr', 'static'] },
 	{ title: 'CloudRay', slug: 'cloudray', supports: ['static'] },
 	{ title: 'Seenode', slug: 'seenode', supports: ['ssr'] },
+	{ title: 'Zephyr', slug: 'zephyr', supports: ['static'] },
 ];
 ---
 

public/logos/deployhq.svg

@@ -73,7 +73,7 @@ Installation instructions, editor integration, and additional information can be
 
 ### Biome
 
-[Biome](https://biomejs.dev/) is an all-in-one linter and formatter for the web. [Biome currently has partial support for `.astro` files](https://biomejs.dev/internals/language-support/#html-super-languages-support), and can be used to lint and format the frontmatter in `.astro` files.
+[Biome](https://biomejs.dev/) is an all-in-one linter and formatter for the web. [Biome currently has experimental support for `.astro` files](https://biomejs.dev/internals/language-support/#html-super-languages-support), and can be used to lint and format the frontmatter in `.astro` files.
 
 ### Prettier
 

public/logos/zephyr.svg

@@ -104,7 +104,7 @@ const { records } = await xata.db.Posts.getPaginated({
   ))}
 </ul>
 ```
-It's important to note the SDK needs to be regenerated everytime your schema changes. So, avoid making changes to the generated files the Xata CLI creates because once schema updates, your changes will be overwritten.
+It's important to note the SDK needs to be regenerated every time your schema changes. So, avoid making changes to the generated files the Xata CLI creates because once schema updates, your changes will be overwritten.
 
 
 ## Official Resources

src/components/DeployGuidesNav.astro

@@ -0,0 +1,46 @@
+---
+title: Deploy your Astro Site with DeployHQ
+description: How to deploy your Astro site to the web using DeployHQ.
+sidebar:
+  label: DeployHQ
+type: deploy
+i18nReady: true
+---
+import ReadMore from '~/components/ReadMore.astro';
+import { Steps } from '@astrojs/starlight/components';
+
+You can deploy your Astro project to your own servers using [DeployHQ](https://www.deployhq.com/), a deployment automation platform that builds your code and pushes it to SSH/SFTP servers, FTP servers, cloud storage (e.g. Amazon S3, Cloudflare R2), and modern hosting platforms (e.g. Netlify, Heroku).
+
+:::note
+DeployHQ does not host your site. It automates building your Astro project and deploying the built files to your chosen hosting provider or server.
+:::
+
+## How to deploy
+
+<Steps>
+1. If you do not already have one, sign up for a [DeployHQ account](https://www.deployhq.com/).
+
+2. From the DeployHQ web interface, create a new project and connect the Git repository for your Astro project (GitHub, GitLab, Bitbucket, or any private repository). You will also need to authorize DeployHQ to access your repository.
+
+3. Add a server and enter your server details:
+
+   - Give your server a name.
+   - Select your protocol (SSH/SFTP, FTP, or cloud platform).
+   - Enter your server hostname, username, and password/SSH key.
+   - Set **Deployment Path** to your web root (e.g. `public_html/`).
+
+4. In your project settings, navigate to **Build Pipeline** and add your build commands:
+
+   ```bash
+   npm install
+   npm run build
+   ```
+
+5. Click **Deploy Project**, then select your server and click **Deploy** to start your first deployment.
+</Steps>
+
+Your Astro site will be built and deployed to your server. You can enable automatic deployments to deploy on every Git push, or schedule deployments for specific times.
+
+<ReadMore>
+  See [DeployHQ's documentation](https://www.deployhq.com/support) for more info on advanced deployment features.
+</ReadMore>

src/content/docs/en/editor-setup.mdx

@@ -41,13 +41,14 @@ Follow the instructions below to use the GitHub Action to deploy your Astro site
         runs-on: ubuntu-latest
         steps:
           - name: Checkout your repository using git
-            uses: actions/checkout@v4
+            uses: actions/checkout@v5
           - name: Install, build, and upload your site
-            uses: withastro/action@v3
+            uses: withastro/action@v5
             # with:
               # path: . # The root location of your Astro project inside the repository. (optional)
-              # node-version: 20 # The specific version of Node that should be used to build your site. Defaults to 20. (optional)
+              # node-version: 24 # The specific version of Node that should be used to build your site. Defaults to 22. (optional)
               # package-manager: pnpm@latest # The Node package manager that should be used to install dependencies and build your site. Automatically detected based on your lockfile. (optional)
+              # build-cmd: pnpm run build # The command to run to build your site. Runs the package build script/task by default. (optional)
             # env:
               # PUBLIC_POKEAPI: 'https://pokeapi.co/api/v2' # Use single quotation marks for the variable value. (optional)