[feat: organize docs by feature area]

[jakerachleff]

Main Change

This PR changes our top level doc categories to match our new homepage design. Instead of:

how_to_guides:
-> ...
concepts:
-> ...

We instead have our docs in terms of product categories:

observability
-> concepts
-> how to guides
evaluation
-> concepts
-> how to guides
prompt engineering
-> concepts
-> how to guides
deployment
-> concepts
-> how to guides
administration
-> concepts
-> how to guides
-> pricing

Decisions Made

1. Keep tutorials top level
2. Keep self hosting top level
3. Put pricing under administration
4. Combine all conceptual docs under admin (resource hierarchy + usage + billing) into one page for simplicity
5. Clicking on a product area defaults you into the conceptual docs
6. Got rid of the doc card view such that the only place to see all how to guides laid out is by clicking "how to guides"

Still TODO

• Put in all proper vercel.json redirects so this doesn't fuck over our docs links in langsmith

Thoughts for reviewers

I don't think this is the complete change. For example:

1. I'd like to split eval how to guides further into (Experiment UI, Run Evaluations in Code (sections for SDK / REST API / etc)
2. I'd like to move online eval into evaluation from monitoring

Not sure if people prefer incremental changes or big ones here.. I see arguments for both

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
langsmith-docs	✅ Ready (Inspect)	Visit Preview	💬 1 unresolved	Oct 23, 2024 6:29pm