Skip to content

Add generated modal search and docs error reporting support#2356

Open
niemyjski wants to merge 10 commits into
mainfrom
feature/docs-pagefind-exceptionless-client
Open

Add generated modal search and docs error reporting support#2356
niemyjski wants to merge 10 commits into
mainfrom
feature/docs-pagefind-exceptionless-client

Conversation

@niemyjski

@niemyjski niemyjski commented Jul 8, 2026

Copy link
Copy Markdown
Member

Summary

  • add Codex and Aspire wiring to run the Lume docs site locally, with Aspire CLI state stored inside the worktree
  • run Docs as deno task serve through the CommunityToolkit Deno integration for normal development and omit it only from the existing --ci-e2e path
  • replace the dedicated /search/ page and Pagefind task with a generated /search-index.json plus shared modal search opened from the header, shortcuts, or docs sidebar form
  • configure the bundled Exceptionless browser client through client-safe EXCEPTIONLESS_SITE_* repository variables, initialize it before site/search JavaScript, and retain only the Website tag plus session and page context
  • restore the historical site palette: headings use #78B001, content/search links use #578F01, sidebar section links use #78B001, and sidebar leaf links use #777
  • remove branch-specific sidebar/nav/font drift while keeping CSS changes scoped to the search dialog and local review cache behavior
  • simplify the docs configuration by removing the debug-only environment knob, inaccurate Docs/Lume tags, reusable-workflow secret forwarding, the single-use bundle task, and the redundant explicit port argument

Historical Color Notes

  • exceptionless/Website shows the docs TOC palette from Eric J. Smith's 2020-10-22 4543749 "More styling" commit: .toc-list a is #78B001, while .toc-list a:only-child is #777.
  • The older main green #78B001 traces further back through content/assets/css/theme.css blame to Blake Niemyjski's 2015-09-08 WordPress theme CSS commit fe1a5252.
  • The Lume migration's Lighthouse overrides darkened site headings and content links to #4f7600; those global overrides are removed while unrelated Lighthouse and search-dialog CSS remains intact.

Verification

  • git diff --check
  • ruby -e 'require "yaml"; YAML.load_file(".github/workflows/build.yaml"); YAML.load_file(".github/workflows/website.yml")'
  • deno task check
  • deno task verify: Lume build, postbuild search index generation, client bundle, and link verification passed with no broken local links, anchors, or assets
  • configured and unconfigured deno task build: the configured output emits only API key, server URL, and version before /assets/js/site.js; the unconfigured output omits the client script
  • exact local PORT=7141 deno task serve: served /docs/; browser search for Docker returned 11 results
  • dotnet build src/Exceptionless.AppHost/Exceptionless.AppHost.csproj
  • normal AppHost manifest contains Docs as command deno with args task serve; the --ci-e2e manifest contains no Docs resource
  • agent-browser checked /, /why/, /tour/, /news/, and /docs/: headings resolve to rgb(120, 176, 1) and content links resolve to rgb(87, 143, 1)
  • agent-browser checked /docs/api/project-tokens/: API Usage is rgb(120, 176, 1), Client-Scoped Tokens is rgb(119, 119, 119), and content links are rgb(87, 143, 1)
  • agent-browser confirmed stale search results no longer navigate: after a visible docker result, changing to definitely-no-stale-result-match and submitting stayed on the same docs page and showed zero results for the new query
  • agent-browser confirmed modal focus remains inside the search dialog for both Tab and Shift+Tab
  • generated search index verification confirmed long-page content such as QueueEventMigrationsJob is searchable and the global fallback meta description is not indexed as page-specific description text

Breaking Changes

  • None

@niemyjski niemyjski force-pushed the feature/docs-pagefind-exceptionless-client branch from 01f630d to 3f3615e Compare July 8, 2026 03:22

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 01f630d7bb

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread src/Exceptionless.AppHost/Program.cs Outdated
Comment thread docs/_includes/layouts/base.vto Outdated

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 1221593c96

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread .codex/environments/environment.toml Outdated
@niemyjski niemyjski self-assigned this Jul 9, 2026

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: cf03ecf73a

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread src/Exceptionless.AppHost/Program.cs Outdated
Comment thread docs/public/assets/js/search.js Outdated
@niemyjski niemyjski changed the title Add local Lume docs search and error reporting support Add generated modal search and docs error reporting support Jul 9, 2026

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: bdee5712d2

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread src/Exceptionless.AppHost/Program.cs

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 2344e5c9a5

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/_config.ts Outdated

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 61a60c896e

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/public/assets/js/site.js

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 1720ea9aa4

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/public/assets/js/site.js

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 76bfd57089

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/scripts/postbuild.ts Outdated
@niemyjski niemyjski force-pushed the feature/docs-pagefind-exceptionless-client branch from 1b673ee to 127a7d0 Compare July 9, 2026 16:45
niemyjski added 2 commits July 9, 2026 11:49
Use Deno Aspire resource for docs

Polish docs search UI

Use generated modal search for docs

Address docs search review feedback

Cancel docs search debounce on clear

Fix docs search modal button styling

Expose docs search keyboard shortcut

Clarify docs search migration notes

Preserve docs sidebar link color

Align docs search nav on mobile

Fix docs sidebar text color

Restore docs sidebar link color

Match docs sidebar colors to production

Disable caching for local docs server

Use existing nav styling for docs search trigger

Adjust frontend package release age

Reuse theme modal styles for docs search
@niemyjski niemyjski force-pushed the feature/docs-pagefind-exceptionless-client branch from 127a7d0 to f37513e Compare July 9, 2026 16:53

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f37513eca7

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/scripts/postbuild.ts Outdated

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f88731a535

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/_includes/layouts/base.vto Outdated
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

@github-actions

github-actions Bot commented Jul 9, 2026

Copy link
Copy Markdown

Code Coverage

Package Line Rate Branch Rate Complexity Health
Exceptionless.AppHost 38% 39% 144
Exceptionless.Core 72% 64% 8644
Exceptionless.Insulation 24% 23% 205
Exceptionless.Web 79% 67% 5231
Summary 72% (17193 / 23750) 64% (8772 / 13684) 14224

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.

1 participant