Publish the Telemetry sidebar entry

[abrahamdaniels]

"Telemetry" appears as unlinked plain text in the sidebar under "Evaluation and Observability." It is visible as a navigation item but leads nowhere. Users see a promise of telemetry documentation but cannot access it.
Fix: Either publish the Telemetry page with at minimum a stub (even "Coming soon" is better than a dead nav item), or remove the sidebar entry until the page is ready.

Location: docs.mellea.ai sidebar → Evaluation and Observability → Telemetry

[planetf1]

Another aspect: the CI process should verify links. There are some checks, but they do not validate the mintlify config. Ideally we would want to find future bugs like this at build time

[ajbozarth]

@abrahamdaniels I just want to confirm this isn't a bug you're seeing. The telemetry navigation item is a foldable drop down, if you click it it should open up and show the telemetry pages:

closed (default)

open

The the Overview page is the actual telemetry page located at https://docs.mellea.ai/evaluation-and-observability/telemetry
This is a limitation of the website, as foldable sections cannot link to actual pages (otherwise I would have done so).

I was also unaware when I added this that it was a new pattern in our docs sidebar, so if we'd rather remove it for consistency I can do that.

@abrahamdaniels so are you seeing an actual bug where the dropdown isn't opening or is it just confusing UX?

[abrahamdaniels]

Understood -- this is more of a confusing UX decision than. My thinking is that the 'Overview' should be visible when you click on 'Telemetry', and we have the drop-down items as a hamburger list on the right panel.

Thoughts?

[ajbozarth]

@abrahamdaniels Unfortunately Mintlify doesn't support making a group label simultaneously a link and a collapsible, so the right-panel sub-items layout isn't something we can do without custom JS.

The two practical options:

1. Rename the first page's sidebarTitle from "Overview" to "Telemetry" — the group then reads "Telemetry > Telemetry" which is a bit redundant but makes it clear that clicking into the section lands you on a real page.

2. Flatten the structure — remove the "Telemetry" group and list the pages directly under "Evaluation and Observability". This is arguably cleaner and avoids the nested-group confusion entirely.

Though I'd prefer leaving as is, of these two options I would choose 2.

[abrahamdaniels]

@ajbozarth It seems odd, given it's the only option with a drop-down. The issue with a label simultaneously not being a link and collapsible 'feels' like a bug as a user

The top line for Evaluate with LLM-as-a-Judge is Evaluation and Observability, while the others are bucketed under Telemetry. Can we separate them? Also, should Telemetry be OpenTelemetry given it's all related to the OS project. We call that out in the overview as well

[ajbozarth]

It seems odd, given it's the only option with a drop-down

I'd actually argue we should use the foldable sections more to shrink the footprint of the side bar

Can we separate them?

Yes we can, that is easy to update

Also, should Telemetry be OpenTelemetry given it's all related to the OS project.

Actually it's just the summary page for Mellea's telemetry, not just OTEL

@abrahamdaniels I can update the sidebar to flatten them if you still want that, but I still think using drop-downs in the sidebar is something we should do more of rather than remove