github · docs-bot · Mar 19, 2026 · Mar 19, 2026 · Mar 19, 2026 · Mar 19, 2026
diff --git a/.gitattributes b/.gitattributes
@@ -1,7 +1,7 @@
 # Set default behavior, in case users don't have core.autocrlf set.
 * text=auto
-# Explicitly declare text files we want to always be normalized and converted
-# to native line endings on checkout.
-*.md text diff=markdown
+# Explicitly declare text files we want to always be normalized, and for
+# Markdown files, enforce LF line endings on checkout.
+*.md text eol=lf diff=markdown
 *.json.br filter=lfs diff=lfs merge=lfs -text
 .github/workflows/*.lock.yml linguist-generated=true merge=ours
diff --git a/Dockerfile b/Dockerfile
@@ -155,9 +155,11 @@ ENV BUILD_SHA=$BUILD_SHA
 
 # V8 heap limit as a percentage of the container cgroup memory limit.
 # Uses --max-old-space-size-percentage (Node 24+) so the heap adapts
-# automatically when K8s memory limits change. 75% leaves ~25% headroom
+# automatically when K8s memory limits change. 80% leaves ~20% headroom
 # for off-heap memory (Buffers, V8 code cache, libuv) and OS overhead.
-ENV NODE_OPTIONS="--max-old-space-size-percentage=75"
+# Raised from 75% on advice from performance engineering to reduce GC
+# pressure during traffic spikes.
+ENV NODE_OPTIONS="--max-old-space-size-percentage=80"
 
 # Entrypoint to start the server
 CMD ["node_modules/.bin/tsx", "src/frame/server.ts"]
diff --git a/config/moda/configuration/default/env.yaml b/config/moda/configuration/default/env.yaml
@@ -3,7 +3,7 @@ data:
   NODE_ENV: production
   # Matches the Dockerfile ENV. Both set the same value so that
   # the heap limit is correct regardless of config-layering order.
-  NODE_OPTIONS: '--max-old-space-size-percentage=75'
+  NODE_OPTIONS: '--max-old-space-size-percentage=80'
   PORT: '4000'
   ENABLED_LANGUAGES: 'en,es,ja,pt,zh,ru,fr,ko,de'
   RATE_LIMIT_MAX: '21'

diff --git a/config/moda/configuration/production/env.yaml b/config/moda/configuration/production/env.yaml
@@ -3,7 +3,7 @@ data:
   NODE_ENV: production
   # Matches the Dockerfile ENV. Both set the same value so that
   # the heap limit is correct regardless of config-layering order.
-  NODE_OPTIONS: '--max-old-space-size-percentage=75'
+  NODE_OPTIONS: '--max-old-space-size-percentage=80'
   PORT: '4000'
   ENABLED_LANGUAGES: 'en,es,ja,pt,zh,ru,fr,ko,de'
   RATE_LIMIT_MAX: '21'

diff --git a/content/codespaces/about-codespaces/codespaces-features.md b/content/codespaces/about-codespaces/codespaces-features.md
@@ -7,6 +7,8 @@ versions:
   fpt: '*'
   ghec: '*'
 contentType: concepts
+category:
+  - Get started
 ---
 
 ## {% data variables.product.prodname_github_codespaces %} features

diff --git a/content/codespaces/about-codespaces/deep-dive.md b/content/codespaces/about-codespaces/deep-dive.md
@@ -9,6 +9,8 @@ versions:
 redirect_from:
   - /codespaces/getting-started/deep-dive
 contentType: get-started
+category:
+  - Get started
 ---
 
 {% data variables.product.prodname_github_codespaces %} is an instant, cloud-based development environment that uses a container to provide you with common languages, tools, and utilities for development. {% data variables.product.prodname_github_codespaces %} is also configurable, allowing you to create a customized development environment for your project. By configuring a custom development environment for your project, you can have a repeatable codespace configuration for all users of your project.

diff --git a/content/codespaces/about-codespaces/understanding-the-codespace-lifecycle.md b/content/codespaces/about-codespaces/understanding-the-codespace-lifecycle.md
@@ -11,6 +11,8 @@ redirect_from:
   - /codespaces/about-codespaces/the-codespace-lifecycle
   - /codespaces/getting-started/understanding-the-codespace-lifecycle
 contentType: concepts
+category:
+  - Get started
 ---
 
 > [!NOTE]

diff --git a/content/codespaces/about-codespaces/what-are-codespaces.md b/content/codespaces/about-codespaces/what-are-codespaces.md
@@ -9,6 +9,8 @@ versions:
 redirect_from:
   - /codespaces/overview
 contentType: concepts
+category:
+  - Get started
 ---
 
 ## Introduction

diff --git a/...aces/customizing-your-codespace/changing-the-machine-type-for-your-codespace.md b/...aces/customizing-your-codespace/changing-the-machine-type-for-your-codespace.md
@@ -8,6 +8,8 @@ versions:
 redirect_from:
   - /codespaces/developing-in-codespaces/changing-the-machine-type-for-your-codespace
 contentType: how-tos
+category:
+  - Customize your codespace
 ---
 
 ## About machine types

diff --git a/content/codespaces/customizing-your-codespace/changing-the-shell-in-a-codespace.md b/content/codespaces/customizing-your-codespace/changing-the-shell-in-a-codespace.md
@@ -6,6 +6,8 @@ versions:
   fpt: '*'
   ghec: '*'
 contentType: how-tos
+category:
+  - Customize your codespace
 ---
 
 When you're working in a codespace, you can open a new terminal window with a shell of your choice, change your default shell for new terminal windows, or install a new shell. You can also use dotfiles to configure your shell.

diff --git a/content/codespaces/customizing-your-codespace/renaming-a-codespace.md b/content/codespaces/customizing-your-codespace/renaming-a-codespace.md
@@ -6,6 +6,8 @@ versions:
   ghec: '*'
 shortTitle: Rename a codespace
 contentType: how-tos
+category:
+  - Create and manage codespaces
 ---
 
 ## About renaming a codespace

diff --git a/content/codespaces/developing-in-a-codespace/connecting-to-a-private-network.md b/content/codespaces/developing-in-a-codespace/connecting-to-a-private-network.md
@@ -7,6 +7,8 @@ versions:
 redirect_from:
   - /codespaces/developing-in-codespaces/connecting-to-a-private-network
 contentType: how-tos
+category:
+  - Create and manage codespaces
 ---
 
 ## About codespace networking

diff --git a/...t/codespaces/developing-in-a-codespace/creating-a-codespace-for-a-repository.md b/...t/codespaces/developing-in-a-codespace/creating-a-codespace-for-a-repository.md
@@ -11,6 +11,8 @@ versions:
   ghec: '*'
 shortTitle: Create a codespace for a repo
 contentType: how-tos
+category:
+  - Create and manage codespaces
 ---
 
 ## About creating a codespace for a repository

diff --git a/...nt/codespaces/developing-in-a-codespace/creating-a-codespace-from-a-template.md b/...nt/codespaces/developing-in-a-codespace/creating-a-codespace-from-a-template.md
@@ -8,6 +8,8 @@ shortTitle: Create a codespace from a template
 redirect_from:
   - /codespaces/developing-in-codespaces/creating-a-codespace-from-a-template
 contentType: how-tos
+category:
+  - Create and manage codespaces
 ---
 
 # About templates for {% data variables.product.prodname_github_codespaces %}

diff --git a/...s/developing-in-a-codespace/default-environment-variables-for-your-codespace.md b/...s/developing-in-a-codespace/default-environment-variables-for-your-codespace.md
@@ -8,6 +8,8 @@ versions:
 redirect_from:
   - /codespaces/developing-in-codespaces/default-environment-variables-for-your-codespace
 contentType: concepts
+category:
+  - Write code in a codespace
 ---
 
 ## About default environment variables

diff --git a/content/codespaces/developing-in-a-codespace/deleting-a-codespace.md b/content/codespaces/developing-in-a-codespace/deleting-a-codespace.md
@@ -10,6 +10,8 @@ versions:
   ghec: '*'
 shortTitle: Delete a codespace
 contentType: how-tos
+category:
+  - Create and manage codespaces
 ---
 
 ## Overview

diff --git a/content/codespaces/developing-in-a-codespace/developing-in-a-codespace.md b/content/codespaces/developing-in-a-codespace/developing-in-a-codespace.md
@@ -10,6 +10,8 @@ versions:
   ghec: '*'
 shortTitle: Develop in a codespace
 contentType: how-tos
+category:
+  - Create and manage codespaces
 ---
 
 ## About development with {% data variables.product.prodname_github_codespaces %}

diff --git a/content/codespaces/developing-in-a-codespace/forwarding-ports-in-your-codespace.md b/content/codespaces/developing-in-a-codespace/forwarding-ports-in-your-codespace.md
@@ -9,6 +9,8 @@ redirect_from:
   - /github/developing-online-with-codespaces/forwarding-ports-in-your-codespace
   - /codespaces/developing-in-codespaces/forwarding-ports-in-your-codespace
 contentType: how-tos
+category:
+  - Write code in a codespace
 ---
 
 ## About forwarded ports

diff --git a/...g-in-a-codespace/getting-started-with-github-codespaces-for-machine-learning.md b/...g-in-a-codespace/getting-started-with-github-codespaces-for-machine-learning.md
@@ -8,6 +8,8 @@ versions:
 redirect_from:
   - /codespaces/developing-in-codespaces/getting-started-with-github-codespaces-for-machine-learning
 contentType: tutorials
+category:
+  - Write code in a codespace
 ---
 
 ## Introduction

diff --git a/content/codespaces/developing-in-a-codespace/opening-an-existing-codespace.md b/content/codespaces/developing-in-a-codespace/opening-an-existing-codespace.md
@@ -8,6 +8,8 @@ shortTitle: Open an existing codespace
 redirect_from:
   - /codespaces/developing-in-codespaces/opening-an-existing-codespace
 contentType: how-tos
+category:
+  - Create and manage codespaces
 ---
 
 You can reopen any of your active or stopped codespaces on {% data variables.product.github %}, in {% data variables.product.prodname_vscode %}, or by using {% data variables.product.prodname_cli %}. You can't reopen a codespace that has been deleted. See [AUTOTITLE](/codespaces/about-codespaces/understanding-the-codespace-lifecycle).

diff --git a/...veloping-in-a-codespace/persisting-environment-variables-and-temporary-files.md b/...veloping-in-a-codespace/persisting-environment-variables-and-temporary-files.md
@@ -8,6 +8,8 @@ shortTitle: Persist variables and files
 redirect_from:
   - /codespaces/developing-in-codespaces/persisting-environment-variables-and-temporary-files
 contentType: how-tos
+category:
+  - Customize your codespace
 ---
 
 ## Setting persistent environment variables

diff --git a/...codespaces/developing-in-a-codespace/rebuilding-the-container-in-a-codespace.md b/...codespaces/developing-in-a-codespace/rebuilding-the-container-in-a-codespace.md
@@ -9,6 +9,8 @@ redirect_from:
   - /codespaces/codespaces-reference/performing-a-full-rebuild-of-a-container
   - /codespaces/developing-in-codespaces/rebuilding-the-container-in-a-codespace
 contentType: how-tos
+category:
+  - Write code in a codespace
 ---
 
 ## About rebuilding the dev container

diff --git a/content/codespaces/developing-in-a-codespace/stopping-and-starting-a-codespace.md b/content/codespaces/developing-in-a-codespace/stopping-and-starting-a-codespace.md
@@ -8,6 +8,8 @@ shortTitle: Stop a codespace
 redirect_from:
   - /codespaces/developing-in-codespaces/stopping-and-starting-a-codespace
 contentType: how-tos
+category:
+  - Create and manage codespaces
 ---
 
 ## About stopping and starting a codespace

diff --git a/...despaces/developing-in-a-codespace/using-github-codespaces-for-pull-requests.md b/...despaces/developing-in-a-codespace/using-github-codespaces-for-pull-requests.md
@@ -9,6 +9,8 @@ redirect_from:
   - /codespaces/developing-in-codespaces/using-codespaces-for-pull-requests
   - /codespaces/developing-in-codespaces/using-github-codespaces-for-pull-requests
 contentType: how-tos
+category:
+  - Write code in a codespace
 ---
 
 Using a codespace to work on a pull request gives you all the benefits of {% data variables.product.prodname_github_codespaces %}. For more information, see [AUTOTITLE](/codespaces/about-codespaces/codespaces-features).

diff --git a/...aces/developing-in-a-codespace/using-github-codespaces-in-visual-studio-code.md b/...aces/developing-in-a-codespace/using-github-codespaces-in-visual-studio-code.md
@@ -12,6 +12,8 @@ versions:
   fpt: '*'
   ghec: '*'
 contentType: how-tos
+category:
+  - Write code in a codespace
 ---
 
 ## About {% data variables.product.prodname_github_codespaces %} in {% data variables.product.prodname_vscode %}

diff --git a/...codespaces/developing-in-a-codespace/using-github-codespaces-with-github-cli.md b/...codespaces/developing-in-a-codespace/using-github-codespaces-with-github-cli.md
@@ -9,6 +9,8 @@ redirect_from:
   - /codespaces/developing-in-codespaces/using-codespaces-with-github-cli
   - /codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli
 contentType: how-tos
+category:
+  - Write code in a codespace
 ---
 
 ## About {% data variables.product.prodname_cli %}

diff --git a/.../codespaces/developing-in-a-codespace/using-source-control-in-your-codespace.md b/.../codespaces/developing-in-a-codespace/using-source-control-in-your-codespace.md
@@ -8,6 +8,8 @@ shortTitle: Source control
 redirect_from:
   - /codespaces/developing-in-codespaces/using-source-control-in-your-codespace
 contentType: how-tos
+category:
+  - Write code in a codespace
 ---
 
 ## About source control in {% data variables.product.prodname_github_codespaces %}

diff --git a/.../codespaces/developing-in-a-codespace/working-collaboratively-in-a-codespace.md b/.../codespaces/developing-in-a-codespace/working-collaboratively-in-a-codespace.md
@@ -8,6 +8,8 @@ versions:
 redirect_from:
   - /codespaces/developing-in-codespaces/working-collaboratively-in-a-codespace
 contentType: how-tos
+category:
+  - Write code in a codespace
 ---
 
 {% data variables.product.prodname_vs %} Live Share lets you collaboratively edit and debug with others in real time, within a codespace. You can securely share your current codespace, or access a codespace created by someone else.

diff --git a/content/codespaces/guides.md b/content/codespaces/guides.md
diff --git a/content/codespaces/index.md b/content/codespaces/index.md
@@ -7,38 +7,27 @@ intro: >-
 introLinks:
   overview: /codespaces/about-codespaces/what-are-codespaces
   quickstart: /codespaces/quickstart
-featuredLinks:
-  startHere:
-    - >-
-      /codespaces/managing-codespaces-for-your-organization/enabling-or-disabling-github-codespaces-for-your-organization
+layout: discovery-landing
+includedCategories:
+  - Get started
+  - Create and manage codespaces
+  - Write code in a codespace
+  - Customize your codespace
+  - Set up dev containers for a project
+  - Speed up codespace creation with prebuilds
+  - Manage codespaces for your organization
+  - Troubleshoot codespaces
+carousels:
+  recommended:
+    - /codespaces/quickstart
+    - /codespaces/about-codespaces/what-are-codespaces
     - /codespaces/about-codespaces/understanding-the-codespace-lifecycle
-    - >-
-      /codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers
-    - >-
-      /codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces
-    - /billing/concepts/product-billing/github-codespaces
-  guideCards:
-    - /codespaces/about-codespaces/deep-dive
-    - >-
-      /codespaces/developing-in-a-codespace/creating-a-codespace-for-a-repository
+    - /codespaces/developing-in-a-codespace/creating-a-codespace-for-a-repository
     - /codespaces/developing-in-a-codespace/creating-a-codespace-from-a-template
-    - /codespaces/developing-in-a-codespace/opening-an-existing-codespace
-    - >-
-      /codespaces/setting-your-user-preferences/personalizing-github-codespaces-for-your-account
-    - >-
-      /codespaces/developing-in-a-codespace/using-github-codespaces-in-visual-studio-code
-  popular:
-    - >-
-      /codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/setting-up-your-nodejs-project-for-codespaces
-    - >-
-      /codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/setting-up-your-python-project-for-codespaces
-    - >-
-      /codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/setting-up-your-java-project-for-codespaces
-    - >-
-      /codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/setting-up-your-dotnet-project-for-codespaces
-    - >-
-      /codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/setting-up-your-php-project-for-codespaces
-  popularHeading: Set up your project
+    - /codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers
+    - /codespaces/developing-in-a-codespace/using-source-control-in-your-codespace
+    - /codespaces/managing-codespaces-for-your-organization/enabling-or-disabling-github-codespaces-for-your-organization
+    - /codespaces/reference/security-in-github-codespaces
 changelog:
   label: codespaces
 product_video: 'https://www.youtube-nocookie.com/embed/_W9B7qc9lVc'
@@ -52,7 +41,7 @@ redirect_from:
   - >-
     /codespaces/developing-in-a-codespace/using-github-codespaces-in-your-jetbrains-ide
   - /codespaces/reference/using-the-github-codespaces-plugin-for-jetbrains
-layout: product-landing
+  - /codespaces/guides
 versions:
   fpt: '*'
   ghec: '*'
@@ -69,6 +58,4 @@ children:
   - /reference
   - /troubleshooting
   - /the-githubdev-web-based-editor
-  - /guides
 ---
-