Skip to content

[DOCS-15525] Expand Log Findings page for GA - #39682

Draft
maxvp wants to merge 4 commits into
masterfrom
max.phillips/DOCS-15525
Draft

[DOCS-15525] Expand Log Findings page for GA#39682
maxvp wants to merge 4 commits into
masterfrom
max.phillips/DOCS-15525

Conversation

@maxvp

@maxvp maxvp commented Sep 2, 2026

Copy link
Copy Markdown
Collaborator

What does this PR do? What is the motivation?

Addresses DOCS-15525

Expands the hidden Log Findings page ahead of the GA rollout. The page previously carried an overview and a demo video only.

  • Adds a Findings panel section covering where the canvas lives and how to pin or hide it
  • Adds a Capture a finding section with three entry points: a query and its visualization, an individual log event, and selected text in a log message
  • Adds an Organize the canvas section covering rename, drag, resize, auto-organize by query, zoom, and full-screen view
  • Adds a Delete findings section covering single and multi-select deletion, the clear icon in the panel, and undo
  • Adds a Return to a finding section covering double-click and Open in Explorer, plus using findings as investigation checkpoints
  • Adds a Use findings as context section for Ask Bits and Open in Notebooks
  • Adds a Keyboard shortcuts table
  • Adds further_reading entries for Log Explorer, Saved Views, Bits AI chat, and Notebooks

Merge readiness

  • Ready for merge

Open questions:

  • Clear icon and "Add current page as finding". Both are documented based on the finalized design, and the implementation was still in review when this was written. Confirm they shipped, and confirm the final button labels and tooltip wording.
  • Auto-organize. Documented as grouping by query, with a note that moving, resizing, or deleting a finding resets the grouping. Confirm that is still accurate at GA.
  • Notes on findings and copying a canvas link are left out — both are out of GA scope.
  • Finding limits are deliberately omitted, per our conversation.

GA-day follow-ups, tracked separately from this PR:

  • Remove the Preview callout
  • Replace findings_demo.mp4 with a re-recorded video that has no Preview label and shows current button locations
  • Remove private: true and add the page to the left nav

For Datadog employees:

  • ⚠️ Your branch name MUST follow the <name>/<description> convention and include the forward slash (/). If you've already created your PR with an incorrect branch name, please rename your branch and open a fresh PR.
  • 🤖 New: Comment with /review to run an automated check that catches common issues before a Documentation team member reviews your PR.

AI assistance

Used Claude Code to draft the expanded sections from the demo video, the GA plan, and the bug bash script, then reviewed and edited manually.

Additional notes

UI details were derived from the existing demo video, so they reflect the Preview build. Anything that moved between Preview and GA needs a second pass.

Vale

vale hugo/content/en/logs/explorer/findings.md — 0 errors, 0 warnings, 0 suggestions.

Add sections covering the Findings panel, capturing findings from
queries, log events, and selected text, canvas organization, returning
to a finding in Log Explorer, sending findings to Bits AI and Notebooks,
and keyboard shortcuts.
@maxvp maxvp added the WORK IN PROGRESS No review needed, it's a wip ;) label Sep 2, 2026
@github-actions

github-actions Bot commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

Preview links (active after the build_preview check completes)

Modified Files

Define the canvas up front, make the capture subsections consistent
prose covering both UI and keyboard entry points, replace jargon in the
return-to-a-finding and Bits AI sections, and disambiguate what the
clear icon does. Add inline comments for the behaviors still to be
confirmed.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

WORK IN PROGRESS No review needed, it's a wip ;)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant