Skip to content

[Discover] Add context awareness design principles doc#280892

Open
davismcphee wants to merge 1 commit into
elastic:mainfrom
davismcphee:discover-context-awareness-principles
Open

[Discover] Add context awareness design principles doc#280892
davismcphee wants to merge 1 commit into
elastic:mainfrom
davismcphee:discover-context-awareness-principles

Conversation

@davismcphee

@davismcphee davismcphee commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds PRINCIPLES.md to Discover's context awareness framework, documenting the design principles a new profile should uphold (e.g. the ES|QL editor is always present, the data table always reflects the query 1:1, and interactions changing the table's results must be reflected in the query). README.md and DEV_DOCS.md are updated with links to the new doc.

Checklist

  • Any text added follows EUI's writing guidelines, uses sentence case text and includes i18n support
  • Documentation was added for features that require explanation or tutorials
  • Unit or functional tests were updated or added to match the most common scenarios
  • If a plugin configuration key changed, check if it needs to be allowlisted in the cloud and added to the docker list
  • This was checked for breaking HTTP API changes, and any breaking changes have been approved by the breaking-change committee. The release_note:breaking label should be applied in these situations.
  • Flaky Test Runner was used on any tests changed
  • The PR description includes the appropriate Release Notes section, and the correct release_note:* label is applied per the guidelines
  • Review the backport guidelines and apply applicable backport:* labels.

@davismcphee davismcphee self-assigned this Jul 24, 2026
@davismcphee davismcphee added Feature:Discover Discover Application release_note:skip Skip the PR/issue when compiling release notes backport:skip This PR does not require backporting docs Team:DataDiscovery Discover, search (data plugin and KQL), data views, saved searches. For ES|QL, use Team:ES|QL. t// Project:OneDiscover Enrich Discover with contextual awareness labels Jul 24, 2026
@davismcphee
davismcphee marked this pull request as ready for review July 24, 2026 21:59
@davismcphee
davismcphee requested a review from a team as a code owner July 24, 2026 21:59
@infra-vault-gh-plugin-prod

Copy link
Copy Markdown

Pinging @elastic/kibana-data-discovery (Team:DataDiscovery)

@davismcphee
davismcphee requested review from a team July 24, 2026 22:04
@kibanamachine

Copy link
Copy Markdown
Contributor

💛 Build succeeded, but was flaky

Failed CI Steps

Test Failures

  • [job] [logs] Jest Tests #5 / BackLink renders back to selection link when returnAppId and returnPath are present
  • [job] [logs] Scout Lane #12 - stateful-classic / default / local-stateful-classic - Core Web Vitals - displays core web vitals metrics
  • [job] [logs] Scout Lane #1 - stateful-classic / default / local-stateful-classic - Discover tabs - sharing - can share one unsaved tab from a persisted session

Metrics [docs]

✅ unchanged

cc @davismcphee

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

Labels

backport:skip This PR does not require backporting docs Feature:Discover Discover Application Project:OneDiscover Enrich Discover with contextual awareness release_note:skip Skip the PR/issue when compiling release notes Team:DataDiscovery Discover, search (data plugin and KQL), data views, saved searches. For ES|QL, use Team:ES|QL. t//

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants