Skip to content

Conversation

@florent-leborgne
Copy link
Contributor

@florent-leborgne florent-leborgne commented Nov 25, 2025

Summary

This PR updates the page opening of all Discover docs pages. In particular:

  • Check that the frontmatter is correct and contains the right metadata
  • More generally, frontmatter is often missing an intentional description in many docs files
  • Optimized H1
  • Optimized page intro based on basic content types (tutorial/explanation/guide/reference) that provides better context and sets better expectations

These changes follow instructions provided to AI following an onweek project: https://github.com/florent-leborgne/mi-instructions

Generative AI disclosure

  1. Did you use a generative AI (GenAI) tool to assist in creating this contribution?
  • Yes
  • No

Tool(s) and model(s) used: Cursor with Claude Sonnet 4.5

@florent-leborgne florent-leborgne requested review from a team as code owners November 25, 2025 16:32
@florent-leborgne florent-leborgne changed the title Discover first 20 lines Discover first 20 lines optimization Nov 25, 2025
@github-actions
Copy link

github-actions bot commented Nov 25, 2025

✅ Vale Linting Results

No issues found on modified lines!

@florent-leborgne
Copy link
Contributor Author

florent-leborgne commented Nov 26, 2025

@bmorelli25 I went through another small iteration on the instructions especially around the handling of requirements. Lmk what you think now

Copy link
Member

@bmorelli25 bmorelli25 left a comment

Choose a reason for hiding this comment

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

Nice. I like where this ended up. Two small comments.

@florent-leborgne florent-leborgne enabled auto-merge (squash) November 27, 2025 16:56
@florent-leborgne florent-leborgne merged commit 6a67222 into elastic:main Nov 27, 2025
7 of 8 checks passed
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