Skip to content

Docs proposal for overview page edit#2639

Draft
annabellscha wants to merge 6 commits intomainfrom
docs--proposal-for-overview-page-edit
Draft

Docs proposal for overview page edit#2639
annabellscha wants to merge 6 commits intomainfrom
docs--proposal-for-overview-page-edit

Conversation

@annabellscha
Copy link
Contributor

@annabellscha annabellscha commented Mar 10, 2026

Adapts the docs overview page by surfacing the main quickstart actions earlier and adding a lightweight mental-model intro. The page now points users more directly to Get First Trace, Manage First Prompt, and Set Up Evals, while keeping the broader product explanation further down the page.

Core assumption is that people visit docs to get started.

Old version (had the quickstart links at the bottom of the page)
image

New version (pulls up quick starts, continues directly with image as before):
image

@vercel
Copy link

vercel bot commented Mar 10, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
langfuse-docs Ready Ready Preview, Comment Mar 10, 2026 4:47pm

Request Review

@annabellscha annabellscha marked this pull request as draft March 10, 2026 16:03
@dosubot dosubot bot added the size:M This PR changes 30-99 lines, ignoring generated files. label Mar 10, 2026
@dosubot dosubot bot added the documentation Improvements or additions to documentation label Mar 10, 2026
Copy link
Contributor

@annabell

this changes seems sensible, i suggest to loop in @Lotte-Verheyden on to review this (she did the latest docs revamp)

we need to be a bit carful with every new joiner turning the docs from left-to-right (which happened in the past) - new joiners often reverted changes that people on the team specifically made

therefore I suggest you create a list of all your findings and then share them with the broader docs team (marc, jannik, lotte, me) before restructuring docs or changing the "new users wants to get started experience" to discuss findings to avoid going back to structured we specifically wanted to remove

@annabellscha
Copy link
Contributor Author

Agree! Already started noting things down, this one just seemed to help on a quicker ramp up for users and could also helps in finding the AI capabilities quickly.

@Lotte-Verheyden
Copy link
Member

I like it! This one indeed is very sensible, and the "Overview" part of the page is still relatively high up the page so no big risk in changing it. Happy to go through your list if you have time :)

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

Labels

documentation Improvements or additions to documentation size:M This PR changes 30-99 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants