Skip to content

docs: document comment visibility in certified queries#10750

Open
mintlify[bot] wants to merge 2 commits intomasterfrom
mintlify/certified-queries-comments-1777050622
Open

docs: document comment visibility in certified queries#10750
mintlify[bot] wants to merge 2 commits intomasterfrom
mintlify/certified-queries-comments-1777050622

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented Apr 24, 2026

Adds a section to the certified queries page explaining that Markdown comments (<!-- ... -->) are included in the content the agent reads, while YAML frontmatter comments (# ...) are not. This gives developers control over which notes are exposed to the agent vs. kept internal.

Context from the original Slack thread: this is primarily DX guidance for developers authoring certified queries.

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented Apr 24, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
cubed3 🟢 Ready View Preview Apr 24, 2026, 5:11 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@keydunov
Copy link
Copy Markdown
Member

Say that only description and user reuqest are being used when agent is searching for certified queries. Comments can provide additional informantion about query though

@keydunov keydunov changed the title Document comment visibility in certified queries docs: document comment visibility in certified queries Apr 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

pr:community Contribution from Cube.js community members.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant