Skip to content

Update Nitro integration for HotChocolate and Fusion - #9679

Merged
PascalSenn merged 5 commits into
mainfrom
pse/update-nitro-docs
May 12, 2026
Merged

PascalSenn merged 5 commits into
mainfrom
pse/update-nitro-docs

Conversation

@PascalSenn

Copy link
Copy Markdown
Member
  • Added ChilliCream.Nitro.HotChocolate package to documentation and examples.
  • Updated migration guides to reflect package restructuring from 1.x to 16.x.
  • Introduced AddDefaults() method via Roslyn source generator for simplified Nitro integration.
  • Changed configuration methods for Nitro in HotChocolate and Fusion, replacing AddNitro() with ModifyNitroOptions().
  • Consolidated Azure packages into a single ChilliCream.Nitro.Azure package.
  • Updated OpenTelemetry integration to use AddOpenTelemetry() instead of AddNitroExporter().
  • Revised examples and documentation to reflect new configuration patterns and best practices.

- Added `ChilliCream.Nitro.HotChocolate` package to documentation and examples.
- Updated migration guides to reflect package restructuring from `1.x` to `16.x`.
- Introduced `AddDefaults()` method via Roslyn source generator for simplified Nitro integration.
- Changed configuration methods for Nitro in HotChocolate and Fusion, replacing `AddNitro()` with `ModifyNitroOptions()`.
- Consolidated Azure packages into a single `ChilliCream.Nitro.Azure` package.
- Updated OpenTelemetry integration to use `AddOpenTelemetry()` instead of `AddNitroExporter()`.
- Revised examples and documentation to reflect new configuration patterns and best practices.
Copilot AI review requested due to automatic review settings May 12, 2026 03:36
@github-actions github-actions Bot added 📚 documentation This issue is about working on our documentation. 🌶️ website labels May 12, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the documentation set to reflect Nitro v16’s package restructuring and new configuration patterns across HotChocolate, Fusion, Mocha, and OpenTelemetry integrations.

Changes:

  • Updates Nitro/OpenTelemetry docs and examples to use ChilliCream.Nitro + platform integration packages and the new AddNitro(...).AddOpenTelemetry() flow.
  • Adds new Nitro docs for the source-generator-based AddDefaults() experience (Analyzers page) and a comprehensive migration guide from 1.x to 16.x.
  • Updates HotChocolate/Fusion v16 migration/guides to reference the new Nitro migration path and defaults-based integration.

Reviewed changes

Copilot reviewed 15 out of 15 changed files in this pull request and generated 5 comments.

Show a summary per file
File Description
website/src/docs/nitro/open-telemetry/service-monitoring.md Updates service monitoring setup to the new Nitro + OpenTelemetry packages and registration flow.
website/src/docs/nitro/open-telemetry/operation-monitoring.md Updates GraphQL operation monitoring setup to the new Nitro/OpenTelemetry registration approach.
website/src/docs/nitro/open-telemetry/logging.md Updates logging setup to use AddNitro(...).AddOpenTelemetry() instead of per-provider Nitro exporter wiring.
website/src/docs/nitro/nitro-services.md Updates “Connect your API” example to the new package split and service registration style.
website/src/docs/nitro/migration/migrate-from-1-to-16.md Adds a Nitro 1.x → 16.x migration guide covering package renames, API changes, and examples.
website/src/docs/nitro/apis/operation-reporting.md Updates operation reporting setup to use AddDefaults() and new package IDs.
website/src/docs/nitro/apis/fusion.md Updates Fusion docs for v16 Nitro integration (AddNitro + AddDefaults, OpenTelemetry, cache config).
website/src/docs/nitro/analyzers.md Adds documentation for analyzers/source generator warnings and generated AddDefaults().
website/src/docs/mocha/v16/observability.md Updates Mocha Nitro/OpenTelemetry guidance to use the new AddOpenTelemetry() integration.
website/src/docs/hotchocolate/v16/migrating/migrate-from-15-to-16.md Replaces inline Nitro migration details with a link + key changes summary aligned to v16 restructuring.
website/src/docs/hotchocolate/v16/guides/private-api.md Updates first-party API guide to register Nitro via builder.Services.AddNitro() (examples adjusted).
website/src/docs/fusion/v16/migration/migrate-from-15-to-16.md Replaces inline Nitro migration details with a link + key changes summary aligned to v16 restructuring.
website/src/docs/fusion/v16/guides/first-party-api.md Updates the Fusion first-party API guide to use AddNitro().AddDefaults() + adds generator note.
website/src/docs/fusion/v16/deployment-and-ci-cd.md Updates runtime wiring from AddFusion() to AddDefaults() + adds generator note.
website/src/docs/docs.json Adds navigation entries for Nitro “Analyzers” and “Migration”.
Comments suppressed due to low confidence (1)

website/src/docs/nitro/open-telemetry/service-monitoring.md:50

  • Step 3 re-lists OpenTelemetry.Extensions.Hosting even though it’s already included in the required packages list above (and the earlier command pins versions while this one doesn’t). Consider removing the duplicate install line (or keep a single, consistent install block) to avoid confusing readers.
```shell
dotnet add package OpenTelemetry.Extensions.Hosting
dotnet add package OpenTelemetry.Instrumentation.AspNetCore
</details>



---

💡 <a href="/ChilliCream/graphql-platform/new/main?filename=.github/instructions/*.instructions.md" class="Link--inTextBlock" target="_blank" rel="noopener noreferrer">Add Copilot custom instructions</a> for smarter, more guided reviews. <a href="https://docs.github.com/en/copilot/customizing-copilot/adding-repository-custom-instructions-for-github-copilot" class="Link--inTextBlock" target="_blank" rel="noopener noreferrer">Learn how to get started</a>.

Comment thread website/src/docs/nitro/migration/migrate-from-1-to-16.md Outdated
Comment thread website/src/docs/nitro/nitro-services.md
Comment thread website/src/docs/hotchocolate/v16/guides/private-api.md
Comment thread website/src/docs/hotchocolate/v16/guides/private-api.md
Comment thread website/src/docs/hotchocolate/v16/guides/private-api.md
Comment thread website/src/docs/hotchocolate/v16/migrating/migrate-from-15-to-16.md Outdated
@PascalSenn
PascalSenn merged commit c408cc1 into main May 12, 2026
17 checks passed
@PascalSenn
PascalSenn deleted the pse/update-nitro-docs branch May 12, 2026 21:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

📚 documentation This issue is about working on our documentation. 🌶️ website

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants