ci: autfix

bjohansebas · bjohansebas · commit ffc3a01c3620 · 2026-03-31T15:38:53.000-05:00
diff --git a/.github/workflows/update-external-docs.yml b/.github/workflows/update-external-docs.yml
@@ -19,12 +19,25 @@ jobs:
         with:
           persist-credentials: false
 
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: lts/*
+
+      - name: Install dependencies
+        working-directory: astro
+        run: npm ci
+
       - name: Run scripts
         working-directory: .github/scripts
         run: |
           bash ./get-contributing.sh
           bash ./get-readmes.sh
 
+      - name: Fix formatting
+        working-directory: astro
+        run: npm run fix
+
       - name: Create Pull Request
         uses: gr2m/create-or-update-pull-request-action@v1
         env:
@@ -37,7 +50,7 @@ jobs:
 
             cc: @expressjs/docs-wg
           labels: docs
-          branch: external-docs
+          branch: bot/update-external-docs
 
   synchronize-with-crowdin:
     runs-on: ubuntu-latest
diff --git a/astro/src/content/docs/en/4x/guide/behind-proxies.mdx b/astro/src/content/docs/en/4x/guide/behind-proxies.mdx
@@ -5,7 +5,6 @@ description: Learn how to configure Express.js applications to work correctly be
 
 import Alert from '@components/primitives/Alert/Alert.astro';
 
-
 When running an Express app behind a reverse proxy, some of the Express APIs may return different values than expected. In order to adjust for this, the `trust proxy` application setting may be used to expose information provided by the reverse proxy in the Express APIs. The most common issue is express APIs that expose the client's IP address may instead show an internal IP address of the reverse proxy.
 
 <Alert type="info">
diff --git a/astro/src/content/docs/en/4x/guide/debugging.mdx b/astro/src/content/docs/en/4x/guide/debugging.mdx
@@ -5,7 +5,6 @@ description: Learn how to enable and use debugging logs in Express.js applicatio
 
 import Alert from '@components/primitives/Alert/Alert.astro';
 
-
 To see all the internal logs used in Express, set the `DEBUG` environment variable to
 `express:*` when launching your app.
 
diff --git a/astro/src/content/docs/en/4x/guide/error-handling.mdx b/astro/src/content/docs/en/4x/guide/error-handling.mdx
@@ -5,7 +5,6 @@ description: Understand how Express.js handles errors in synchronous and asynchr
 
 import Alert from '@components/primitives/Alert/Alert.astro';
 
-
 _Error Handling_ refers to how Express catches and processes errors that
 occur both synchronously and asynchronously. Express comes with a default error
 handler so you don't need to write your own to get started.
diff --git a/astro/src/content/docs/en/4x/guide/routing.mdx b/astro/src/content/docs/en/4x/guide/routing.mdx
@@ -5,7 +5,6 @@ description: Learn how to define and use routes in Express.js applications, incl
 
 import Alert from '@components/primitives/Alert/Alert.astro';
 
-
 _Routing_ refers to how an application's endpoints (URIs) respond to client requests.
 For an introduction to routing, see [Basic routing](/en/starter/basic-routing).
 
diff --git a/astro/src/content/docs/en/4x/guide/using-middleware.mdx b/astro/src/content/docs/en/4x/guide/using-middleware.mdx
@@ -5,7 +5,6 @@ description: Learn how to use middleware in Express.js applications, including a
 
 import Alert from '@components/primitives/Alert/Alert.astro';
 
-
 Express is a routing and middleware web framework that has minimal functionality of its own: An Express application is essentially a series of middleware function calls.
 
 _Middleware_ functions are functions that have access to the [request object](/en/5x/api#req) (`req`), the [response object](/en/5x/api#res) (`res`), and the next middleware function in the application's request-response cycle. The next middleware function is commonly denoted by a variable named `next`.
diff --git a/astro/src/content/docs/en/4x/guide/using-template-engines.mdx b/astro/src/content/docs/en/4x/guide/using-template-engines.mdx
@@ -5,7 +5,6 @@ description: Discover how to integrate and use template engines like Pug, Handle
 
 import Alert from '@components/primitives/Alert/Alert.astro';
 
-
 A _template engine_ enables you to use static template files in your application. At runtime, the template engine replaces
 variables in a template file with actual values, and transforms the template into an HTML file sent to the client.
 This approach makes it easier to design an HTML page.
diff --git a/astro/src/content/docs/en/4x/guide/writing-middleware.mdx b/astro/src/content/docs/en/4x/guide/writing-middleware.mdx
@@ -5,7 +5,6 @@ description: Learn how to write custom middleware functions for Express.js appli
 
 import Alert from '@components/primitives/Alert/Alert.astro';
 
-
 _Middleware_ functions are functions that have access to the [request object](/en/5x/api#req) (`req`), the [response object](/en/5x/api#res) (`res`), and the `next` function in the application's request-response cycle. The `next` function is a function in the Express router which, when invoked, executes the middleware succeeding the current middleware.
 
 Middleware functions can perform the following tasks:
diff --git a/astro/src/content/docs/en/4x/starter/basic-routing.mdx b/astro/src/content/docs/en/4x/starter/basic-routing.mdx
@@ -5,7 +5,6 @@ description: Learn the fundamentals of routing in Express.js applications, inclu
 
 import Alert from '@components/primitives/Alert/Alert.astro';
 
-
 _Routing_ refers to determining how an application responds to a client request to a particular endpoint, which is a URI (or path) and a specific HTTP request method (GET, POST, and so on).
 
 Each route can have one or more handler functions, which are executed when the route is matched.
diff --git a/astro/src/content/docs/en/4x/starter/generator.mdx b/astro/src/content/docs/en/4x/starter/generator.mdx
@@ -5,7 +5,6 @@ description: Learn how to use the Express application generator tool to quickly
 
 import Alert from '@components/primitives/Alert/Alert.astro';
 
-
 Use the application generator tool, `express-generator`, to quickly create an application skeleton.
 
 You can run the application generator with the `npx` command (available in Node.js 8.2.0).
diff --git a/astro/src/content/docs/en/4x/starter/hello-world.mdx b/astro/src/content/docs/en/4x/starter/hello-world.mdx
@@ -5,7 +5,6 @@ description: Get started with Express.js by building a simple 'Hello World' appl
 
 import Alert from '@components/primitives/Alert/Alert.astro';
 
-
 <Alert type="info">
 
 Embedded below is essentially the simplest Express app you can create. It is a single file app
diff --git a/astro/src/content/docs/en/4x/starter/installing.mdx b/astro/src/content/docs/en/4x/starter/installing.mdx
@@ -5,7 +5,6 @@ description: Learn how to install Express.js in your Node.js environment, includ
 
 import Alert from '@components/primitives/Alert/Alert.astro';
 
-
 Before you begin, make sure you have [Node.js](https://nodejs.org/) 0.10 or higher installed. Then, create a directory for your application and navigate into it.
 
 ```bash
diff --git a/astro/src/content/docs/en/4x/starter/static-files.mdx b/astro/src/content/docs/en/4x/starter/static-files.mdx
@@ -5,7 +5,6 @@ description: Understand how to serve static files like images, CSS, and JavaScri
 
 import Alert from '@components/primitives/Alert/Alert.astro';
 
-
 To serve static files such as images, CSS files, and JavaScript files, use the `express.static` built-in middleware function in Express.
 
 The function signature is:
diff --git a/astro/src/content/docs/en/5x/guide/behind-proxies.mdx b/astro/src/content/docs/en/5x/guide/behind-proxies.mdx
@@ -5,7 +5,6 @@ description: Learn how to configure Express.js applications to work correctly be
 
 import Alert from '@components/primitives/Alert/Alert.astro';
 
-
 When running an Express app behind a reverse proxy, some of the Express APIs may return different values than expected. In order to adjust for this, the `trust proxy` application setting may be used to expose information provided by the reverse proxy in the Express APIs. The most common issue is express APIs that expose the client's IP address may instead show an internal IP address of the reverse proxy.
 
 <Alert type="info">
diff --git a/astro/src/content/docs/en/5x/guide/debugging.mdx b/astro/src/content/docs/en/5x/guide/debugging.mdx
@@ -5,7 +5,6 @@ description: Learn how to enable and use debugging logs in Express.js applicatio
 
 import Alert from '@components/primitives/Alert/Alert.astro';
 
-
 To see all the internal logs used in Express, set the `DEBUG` environment variable to
 `express:*` when launching your app.
 
diff --git a/astro/src/content/docs/en/5x/guide/error-handling.mdx b/astro/src/content/docs/en/5x/guide/error-handling.mdx
@@ -5,7 +5,6 @@ description: Understand how Express.js handles errors in synchronous and asynchr
 
 import Alert from '@components/primitives/Alert/Alert.astro';
 
-
 _Error Handling_ refers to how Express catches and processes errors that
 occur both synchronously and asynchronously. Express comes with a default error
 handler so you don't need to write your own to get started.
diff --git a/astro/src/content/docs/en/5x/guide/routing.mdx b/astro/src/content/docs/en/5x/guide/routing.mdx
@@ -5,7 +5,6 @@ description: Learn how to define and use routes in Express.js applications, incl
 
 import Alert from '@components/primitives/Alert/Alert.astro';
 
-
 _Routing_ refers to how an application's endpoints (URIs) respond to client requests.
 For an introduction to routing, see [Basic routing](/en/starter/basic-routing).
 
diff --git a/astro/src/content/docs/en/5x/guide/using-middleware.mdx b/astro/src/content/docs/en/5x/guide/using-middleware.mdx
@@ -5,7 +5,6 @@ description: Learn how to use middleware in Express.js applications, including a
 
 import Alert from '@components/primitives/Alert/Alert.astro';
 
-
 Express is a routing and middleware web framework that has minimal functionality of its own: An Express application is essentially a series of middleware function calls.
 
 _Middleware_ functions are functions that have access to the [request object](/en/5x/api#req) (`req`), the [response object](/en/5x/api#res) (`res`), and the next middleware function in the application's request-response cycle. The next middleware function is commonly denoted by a variable named `next`.
diff --git a/astro/src/content/docs/en/5x/guide/using-template-engines.mdx b/astro/src/content/docs/en/5x/guide/using-template-engines.mdx
@@ -5,7 +5,6 @@ description: Discover how to integrate and use template engines like Pug, Handle
 
 import Alert from '@components/primitives/Alert/Alert.astro';
 
-
 A _template engine_ enables you to use static template files in your application. At runtime, the template engine replaces
 variables in a template file with actual values, and transforms the template into an HTML file sent to the client.
 This approach makes it easier to design an HTML page.
diff --git a/astro/src/content/docs/en/5x/guide/writing-middleware.mdx b/astro/src/content/docs/en/5x/guide/writing-middleware.mdx
@@ -5,7 +5,6 @@ description: Learn how to write custom middleware functions for Express.js appli
 
 import Alert from '@components/primitives/Alert/Alert.astro';
 
-
 _Middleware_ functions are functions that have access to the [request object](/en/5x/api#req) (`req`), the [response object](/en/5x/api#res) (`res`), and the `next` function in the application's request-response cycle. The `next` function is a function in the Express router which, when invoked, executes the middleware succeeding the current middleware.
 
 Middleware functions can perform the following tasks:
diff --git a/astro/src/content/docs/en/5x/starter/basic-routing.mdx b/astro/src/content/docs/en/5x/starter/basic-routing.mdx
@@ -5,7 +5,6 @@ description: Learn the fundamentals of routing in Express.js applications, inclu
 
 import Alert from '@components/primitives/Alert/Alert.astro';
 
-
 _Routing_ refers to determining how an application responds to a client request to a particular endpoint, which is a URI (or path) and a specific HTTP request method (GET, POST, and so on).
 
 Each route can have one or more handler functions, which are executed when the route is matched.
diff --git a/astro/src/content/docs/en/5x/starter/examples.mdx b/astro/src/content/docs/en/5x/starter/examples.mdx
@@ -5,7 +5,6 @@ description: Explore a collection of Express.js application examples covering va
 
 import Alert from '@components/primitives/Alert/Alert.astro';
 
-
 This page contains list of examples using Express.
 
 - [auth](https://github.com/expressjs/express/tree/master/examples/auth) - Authentication with login and password
diff --git a/astro/src/content/docs/en/5x/starter/generator.mdx b/astro/src/content/docs/en/5x/starter/generator.mdx
@@ -5,7 +5,6 @@ description: Learn how to use the Express application generator tool to quickly
 
 import Alert from '@components/primitives/Alert/Alert.astro';
 
-
 Use the application generator tool, `express-generator`, to quickly create an application skeleton.
 
 You can run the application generator with the `npx` command (available in Node.js 8.2.0).
diff --git a/astro/src/content/docs/en/5x/starter/hello-world.mdx b/astro/src/content/docs/en/5x/starter/hello-world.mdx
@@ -5,7 +5,6 @@ description: Get started with Express.js by building a simple 'Hello World' appl
 
 import Alert from '@components/primitives/Alert/Alert.astro';
 
-
 <Alert type="info">
 
 Embedded below is essentially the simplest Express app you can create. It is a single file app
diff --git a/astro/src/content/docs/en/5x/starter/installing.mdx b/astro/src/content/docs/en/5x/starter/installing.mdx
@@ -5,7 +5,6 @@ description: Learn how to install Express.js in your Node.js environment, includ
 
 import Alert from '@components/primitives/Alert/Alert.astro';
 
-
 Before you begin, make sure you have [Node.js](https://nodejs.org/) 18 or higher installed. Then, create a directory for your application and navigate into it.
 
 ```bash
diff --git a/astro/src/content/docs/en/5x/starter/static-files.mdx b/astro/src/content/docs/en/5x/starter/static-files.mdx
@@ -5,7 +5,6 @@ description: Understand how to serve static files like images, CSS, and JavaScri
 
 import Alert from '@components/primitives/Alert/Alert.astro';
 
-
 To serve static files such as images, CSS files, and JavaScript files, use the `express.static` built-in middleware function in Express.
 
 The function signature is:
diff --git a/astro/src/content/pages/en/advanced/best-practice-security.mdx b/astro/src/content/pages/en/advanced/best-practice-security.mdx
@@ -1,11 +1,10 @@
 ---
-title: "Production Best Practices: Security"
+title: 'Production Best Practices: Security'
 description: Discover crucial security best practices for Express apps in production, including using TLS, input validation, secure cookies, and preventing vulnerabilities.
 ---
 
 import Alert from '@components/primitives/Alert/Alert.astro';
 
-
 The term _"production"_ refers to the stage in the software lifecycle when an application or API is generally available to its end-users or consumers. In contrast, in the _"development"_ stage, you're still actively writing and testing code, and the application is not open to external access. The corresponding system environments are known as _production_ and _development_ environments, respectively.
 
 Development and production environments are usually set up differently and have vastly different requirements. What's fine in development may not be acceptable in production. For example, in a development environment you may want verbose logging of errors for debugging, while the same behavior can become a security concern in a production environment. And in development, you don't need to worry about scalability, reliability, and performance, while those concerns become critical in production.
diff --git a/astro/src/content/pages/en/advanced/security-updates.mdx b/astro/src/content/pages/en/advanced/security-updates.mdx
@@ -5,7 +5,6 @@ description: Review the latest security updates and patches for Express.js, incl
 
 import Alert from '@components/primitives/Alert/Alert.astro';
 
-
 <Alert type="alert">
 
 Node.js vulnerabilities directly affect Express. Therefore, [keep a watch on Node.js
diff --git a/astro/src/content/pages/en/guide/database-integration.mdx b/astro/src/content/pages/en/guide/database-integration.mdx
@@ -5,7 +5,6 @@ description: Discover how to integrate various databases with Express.js applica
 
 import Alert from '@components/primitives/Alert/Alert.astro';
 
-
 Adding the capability to connect databases to Express apps is just a matter of loading an appropriate Node.js driver for the database in your app. This document briefly explains how to add and use some of the most popular Node.js modules for database systems in your Express app:
 
 - [Cassandra](#cassandra)
diff --git a/astro/src/content/pages/en/guide/migrating-4.mdx b/astro/src/content/pages/en/guide/migrating-4.mdx
@@ -5,7 +5,6 @@ description: A guide to migrating your Express.js applications from version 3 to
 
 import Alert from '@components/primitives/Alert/Alert.astro';
 
-
 Express 4 is a breaking change from Express 3. That means an existing Express 3 app will _not_ work if you update the Express version in its dependencies.
 
 This article covers:
diff --git a/astro/src/content/pages/en/guide/migrating-5.mdx b/astro/src/content/pages/en/guide/migrating-5.mdx
@@ -5,7 +5,6 @@ description: A comprehensive guide to migrating your Express.js applications fro
 
 import Alert from '@components/primitives/Alert/Alert.astro';
 
-
 Express 5 is not very different from Express 4; although it maintains the same basic API, there are still changes that break compatibility with the previous version. Therefore, an application built with Express 4 might not work if you update it to use Express 5.
 
 To install this version, you need to have a Node.js version 18 or higher. Then, execute the following command in your application directory:
diff --git a/astro/src/content/pages/en/resources/glossary.mdx b/astro/src/content/pages/en/resources/glossary.mdx
@@ -5,7 +5,6 @@ description: A comprehensive glossary of terms related to Express.js, Node.js, m
 
 import Alert from '@components/primitives/Alert/Alert.astro';
 
-
 ### application
 
 In general, one or more programs that are designed to carry out operations for a specific purpose. In the context of Express, a program that uses the Express API running on the Node.js platform. Might also refer to an [app object](/en/api#express).
