Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 28 additions & 0 deletions .mintlify/Assistant.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
**Language Matching Policy**

Always respond in the same language the user writes in. This is determined by the language of the user's message, not by their location, name, or any other signal.

**Detection rules:**

- Identify the primary language of the user's most recent message and respond entirely in that language.
- If the user switches languages mid-conversation, switch with them. Match the language of their latest message, not earlier ones.
- If a message mixes languages, respond in the dominant language of the message. If it's roughly even, respond in the language the user used for their actual question or request (as opposed to quoted material, code, or pasted content).
- Quoted text, code snippets, error messages, file contents, and pasted documents do not count toward language detection — only the user's own words do. For example, if a user writes in Spanish asking about an English error log, respond in Spanish.

**Response quality requirements:**

- Use natural, fluent, idiomatic phrasing in the target language — not literal translations of English sentence structures.
- Match the appropriate register and formality conventions of that language (e.g., usted/tú in Spanish, Sie/du in German, keigo considerations in Japanese) based on the user's own tone.
- Keep technical terms, proper nouns, product names, and code in their original form where that is the convention in the target language. Do not translate code, variable names, commands, or API parameters.
- Formatting conventions (dates, numbers, currency, punctuation such as « » or 「」) should follow the norms of the target language where natural.

**Edge cases:**

- If you cannot confidently identify the language, default to English and ask the user to confirm their preferred language.
- If the user explicitly requests a specific response language ("answer in English even though I'm writing in French"), honor that explicit instruction over the matching rule.
- Transliterated text (e.g., Hindi written in Latin script, "Romaji" Japanese) counts as that language — respond in the same script and style the user used, unless they ask otherwise.
- Very short messages with no clear language (e.g., "ok", "?", an emoji) inherit the language of the prior conversation turn.

**Consistency:**

- Apply the language choice to the entire response, including headings, lists, captions, and any closing remarks. Do not mix English boilerplate into a non-English response.
28 changes: 16 additions & 12 deletions docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -49,16 +49,6 @@
"github": "https://github.com/microsoft/Xbox-GDK-Samples"
}
},
"fonts": {
"heading": {
"family": "Open Sans",
"weight": 700
},
"body": {
"family": "Open Sans",
"weight": 400
}
},
"styling": {
"eyebrows": "breadcrumbs"
},
Expand Down Expand Up @@ -180,7 +170,7 @@
]
},
{
"tab": "Build & Develop",
"tab": "Build",
"groups": [
{
"group": "Core Features",
Expand Down Expand Up @@ -342,7 +332,7 @@
]
},
{
"tab": "Publishing & Commerce",
"tab": "Publishing",
"groups": [
{
"group": "Publishing & Commerce",
Expand Down Expand Up @@ -491,5 +481,19 @@
]
}
]
},
"fonts": {
"heading": {
"family": "Segoe UI",
"source": "/fonts/SegoeUI-Bold.woff",
"format": "woff",
"weight": 700
},
"body": {
"family": "Segoe UI",
"source": "/fonts/SegoeUI.woff",
"format": "woff",
"weight": 400
}
}
}
Binary file added fonts/SegoeUI-Bold.woff
Binary file not shown.
Binary file added fonts/SegoeUI.woff
Binary file not shown.
136 changes: 74 additions & 62 deletions index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@
title: "XBOX Documentation Hub"
sidebarTitle: "Home"
description: "Xbox game development documentation to develop and publish XBOX games using Microsoft products, tools, and services."
icon: "house"
---

<div className="xbox-hero not-prose">
Expand All @@ -14,55 +15,52 @@ description: "Xbox game development documentation to develop and publish XBOX ga

Jump into the guides most teams use first, from environment setup to release notes and reference material.

<div className="xbox-quick-grid not-prose">
<a className="xbox-quick-card" href="/gdk/get-started">
<div className="xbox-quick-body">
<span className="xbox-quick-title">Get started with the GDK</span>
<p>Pick a development path, install the toolchain, and build your first console or PC project.</p>
<span className="xbox-quick-link">Read guide →</span>
</div>
<div className="xbox-quick-thumb xbox-thumb-1" />
</a>

<a className="xbox-quick-card" href="/onboarding">
<div className="xbox-quick-body">
<h3>Onboard with ID\@Xbox</h3>

<span className="xbox-quick-title">Onboard with ID@Xbox</span>
<p>
Complete the NDA, concept approval, and Partner Center setup that unlock
GDK access.
</p>

<span className="xbox-quick-link">Read guide →</span>

</div>

<div className="xbox-quick-thumb xbox-thumb-2" />
</a>

<div className="xbox-quick-grid not-prose">
<a className="xbox-quick-card" href="/gdk/get-started">
<div className="xbox-quick-body">
<h3>Get started with the GDK</h3>
<p>Pick a development path, install the toolchain, and build your first console or PC project.</p>
<span className="xbox-quick-link">Read guide →</span>
</div>

<div className="xbox-quick-thumb xbox-thumb-1" />
</a>

<a className="xbox-quick-card" href="/gdk/download-install">
<div className="xbox-quick-body">
<h3>Download & install</h3>

<p>
Grab the latest GDK release and configure Visual Studio for Xbox and
Windows targets.
</p>

<span className="xbox-quick-link">Read guide →</span>
</div>

<div className="xbox-quick-thumb xbox-thumb-3" />
</a>
<a className="xbox-quick-card" href="/gdk/download-install">
<div className="xbox-quick-body">
<span className="xbox-quick-title">Download &amp; install</span>
<p>
Grab the latest GDK release and configure Visual Studio for Xbox and
Windows targets.
</p>
<span className="xbox-quick-link">Read guide →</span>
</div>
<div className="xbox-quick-thumb xbox-thumb-3" />
</a>

<a className="xbox-quick-card" href="/reference/system-overview">
<div className="xbox-quick-body">
<h3>API reference</h3>
<span className="xbox-quick-title">API reference</span>
<p>Browse Gaming Runtime, Xbox Services, and platform APIs across the full GDK surface.</p>
<span className="xbox-quick-link">Read guide →</span>
</div>

<div className="xbox-quick-thumb xbox-thumb-4" />

</a>
</div>

Expand All @@ -75,13 +73,15 @@ Choose the entry point that matches your platform, engine, and stage of developm
Write once with the shared Game Core model and target Xbox Series X|S, Xbox One, and Windows PC.
</Card>

<Card title="Backend with PlayFab" icon="server" href="/playfab/overview">
Add player accounts, economy, multiplayer, and live ops with PlayFab managed services.
</Card>
<Card title="Backend with PlayFab" icon="server" href="/playfab/overview">
Add player accounts, economy, multiplayer, and live ops with PlayFab managed
services.
</Card>

<Card title="Xbox Services integration" icon="trophy" href="/services/overview">
Wire up achievements, leaderboards, multiplayer, cloud saves, and social features.
</Card>
<Card title="Xbox Services integration" icon="trophy" href="/services/overview">
Wire up achievements, leaderboards, multiplayer, cloud saves, and social
features.
</Card>

<Card title="Publish to the Store" icon="store" href="/publishing/overview">
Package your title, meet certification, and ship to the Microsoft Store and Xbox.
Expand All @@ -97,21 +97,21 @@ The features most teams reach for while building a title.
Define identity, capabilities, and packaging metadata in `MicrosoftGame.config`.
</Card>

<Card title="Packaging" icon="box" href="/gdk/packaging">
Build MSIXVC and loose packages for testing, submission, and distribution.
</Card>
<Card title="Packaging" icon="box" href="/gdk/packaging">
Build MSIXVC and loose packages for testing, submission, and distribution.
</Card>

<Card title="Game saves" icon="floppy-disk" href="/gdk/game-saves">
Persist progress with connected storage that roams across devices.
</Card>
<Card title="Game saves" icon="floppy-disk" href="/gdk/game-saves">
Persist progress with connected storage that roams across devices.
</Card>

<Card title="Input" icon="gamepad" href="/gdk/input">
Handle gamepads, keyboard, and mouse with the GameInput API.
</Card>
<Card title="Input" icon="gamepad" href="/gdk/input">
Handle gamepads, keyboard, and mouse with the GameInput API.
</Card>

<Card title="Networking" icon="network-wired" href="/gdk/networking">
Connect players with secure sockets, peer-to-peer, and service traffic.
</Card>
<Card title="Networking" icon="network-wired" href="/gdk/networking">
Connect players with secure sockets, peer-to-peer, and service traffic.
</Card>

<Card title="Storage" icon="hard-drive" href="/gdk/storage">
Manage local and connected storage across console and PC.
Expand All @@ -127,21 +127,33 @@ Tools, samples, and references to keep you moving.
Profilers, deployment, and diagnostics for console and PC development.
</Card>

<Card title="Visual Studio" icon="code" href="/tools/visual-studio">
Set up project templates, debugging, and deployment for GDK titles.
</Card>

<Card title="Xbox service tools" icon="terminal" href="/tools/xbox-service-tools">
Configure sandboxes, test accounts, and service-side settings.
</Card>

<Card title="API reference" icon="brackets-curly" href="/reference/system-overview">
Gaming Runtime, Xbox Services, and platform API documentation.
</Card>

<Card title="Error codes" icon="circle-exclamation" href="/reference/error-codes">
Look up GDK and Xbox Services error codes and how to resolve them.
</Card>
<Card title="Visual Studio" icon="code" href="/tools/visual-studio">
Set up project templates, debugging, and deployment for GDK titles.
</Card>

<Card
title="Xbox service tools"
icon="terminal"
href="/tools/xbox-service-tools"
>
Configure sandboxes, test accounts, and service-side settings.
</Card>

<Card
title="API reference"
icon="brackets-curly"
href="/reference/system-overview"
>
Gaming Runtime, Xbox Services, and platform API documentation.
</Card>

<Card
title="Error codes"
icon="circle-exclamation"
href="/reference/error-codes"
>
Look up GDK and Xbox Services error codes and how to resolve them.
</Card>

<Card title="GDK samples" icon="github" href="https://github.com/microsoft/Xbox-GDK-Samples">
Browse official, buildable samples on GitHub for every major feature.
Expand All @@ -160,4 +172,4 @@ Use the getting started guides to set up your environment, choose a platform pat
<a className="xbox-cta-secondary" href="/onboarding">
Onboarding →
</a>
</div>
</div>
Loading