Skip to content

Improve MiniProfiler module documentation - #19631

Open
agriffard wants to merge 1 commit into
mainfrom
agriffard-improve-miniprofiler-docs
Open

Improve MiniProfiler module documentation#19631
agriffard wants to merge 1 commit into
mainfrom
agriffard-improve-miniprofiler-docs

Conversation

@agriffard

@agriffard agriffard commented Jul 31, 2026

Copy link
Copy Markdown
Member

Summary

The MiniProfiler reference still described a removed admin option and omitted important runtime and security behavior. This update aligns the canonical guidance with the current module implementation.

  • documents tenant activation, frontend and admin permissions, middleware timing coverage, YesSql and shape integrations, and result storage behavior
  • adds an environment-gated, compile-accurate configuration example with explicit authentication and authorization for MiniProfiler's early result route
  • covers production safeguards, multi-instance limitations, widget customization, custom timings, and troubleshooting while preserving the existing video

Validation

  • python -m mkdocs build
  • compiled the documented host configuration against the current Orchard Core projects

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
The feature can also be enabled from a recipe:

```json
{

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

To avoid copy/paste issues, should wrap this with
{
"steps": [
// the step code goes here
]
}

Comment on lines +20 to +33
For development applications, the host can make the feature always enabled for every tenant:

```csharp
using Microsoft.Extensions.DependencyInjection;

var builder = WebApplication.CreateBuilder(args);

var orchardCoreBuilder = builder.Services.AddOrchardCms();

if (builder.Environment.IsDevelopment())
{
orchardCoreBuilder.EnableFeature("OrchardCore.MiniProfiler");
}
```

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

this section is not needed. The MiniProfiler is a feature that can be enabled/disabled via UI and that should ne enough. this is not a special use case for MiniProfile and can be used for any feature


Requests that do not render an Orchard layout, such as APIs and decoupled responses, are still profiled but do not receive a widget. The widget also requires the active theme or admin theme to render the `Footer` zone.

## Configure MiniProfiler

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

this is just too much to share in the document

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants