Curate llms.txt descriptions and navigation ordering for data model primer - #176
Draft
tylergoerzen-mxp with Copilot wants to merge 3 commits into
Draft
Curate llms.txt descriptions and navigation ordering for data model primer#176tylergoerzen-mxp with Copilot wants to merge 3 commits into
tylergoerzen-mxp with Copilot wants to merge 3 commits into
Conversation
Co-authored-by: tylergoerzen-mxp <259741734+tylergoerzen-mxp@users.noreply.github.com>
Contributor
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
Copilot
AI
changed the title
[WIP] Curate llms.txt descriptions and ordering
Curate llms.txt descriptions and navigation ordering for data model primer
Aug 18, 2026
Contributor
Confidence Score: 5/5The PR appears safe to merge. No blocking failure remains.
|
| Filename | Overview |
|---|---|
| docs.json | Moves Data Structure before Tracking Methods without changing the contained navigation entries. |
| docs/data-structure/group-analytics/group-analytics-implementation.mdx | Replaces the prior inaccurate query claim with a description aligned to the implementation topics. |
| docs/data-structure/concepts.mdx | Expands the description to enumerate the four Mixpanel data categories and their relationships. |
| docs/what-is-mixpanel.mdx | Adds a concise platform-overview description for generated documentation indexes. |
Reviews (2): Last reviewed commit: "Correct descriptions that misdescribe th..." | Re-trigger Greptile
![greptile-apps[bot]](https://avatars.githubusercontent.com/in/867647?s=60&v=4){kind=small}
Mintlify builds llms.txt from these descriptions, so a wrong one routes AI assistants to the wrong page. Verified each against the page headings: - group-analytics-faq promised setup, which lives on the implementation page; group-analytics-implementation promised querying, which lives on the FAQ. The two siblings pointed at each other's content. - data-type listed five types; the page documents seven, and half of it covers the two that were missing (object, list of objects). - properties listed four property types; the table has seven. - user-profiles described sending properties, but the page is mostly an import, backfill, and delete reference. Also split the near-identical events-and-properties and what-to-track descriptions, and add descriptions to three section hubs that rendered bare in llms.txt. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
AEO improvements to the data model primer section: adds/improves
descriptionfrontmatter on key pages (used by Mintlify to generatellms.txt) and reorders navigation so the data model content precedes tracking implementation docs.Navigation ordering (
docs.json)DATA INsection — data model concepts should be understood before tracking implementation detailsDescription additions/improvements
Pages that were missing descriptions or had low-signal ones:
what-is-mixpanelwhat-to-trackdata-structure/concepts"How Mixpanel data is organized"data-structure/events-and-properties"Capture behaviors and actions"data-structure/user-profiles"Demographic attributes for your users"group-analytics-implementationgroup-analytics-faqproperty-reference/propertiesproperty-reference/data-type