Some customers mentioned that it was too hard to get started when
clicking on the evals docs. Now, when you click on `evaluation` in the
side bar, you are taken to a evals specific quick start that matches the
one we have in our app for onboarding.
Also updated our how to guide on defining evaluators to reference a page
saying what examples actually are
This PR upgrades docusaurus from v2 to v3 so we can take advantage of
their latest features.
## Changes needed for v2 -> v3 upgrade
1. **Legacy Cookbook Notebook Converter**: Had to update our old
cookbook notebook converter. This logic now has bad rendering in one
special case, which is pandas dataframe outputs no longer show up as
tables and instead show up as raw text. That's fine, since cookbooks are
old, and only left around for posterity
2. **Link syntax changes**: links using ./ instead of ../ were broken.
Made fixes where the link checker failed
3. **Special Character Rendering**: Had to move some output of python
command into output codeblocks to allow rendering of unicode chars
4. **Old Version Banner**: Our version banner code relied on internal
methods in docusaurus v2, so I did some hacking to make them still show
up on our old docs using publicly available APIs
Moves our docs to meet docusaurus standards.
- Current docs moved from `versioned-docs/version-2.0` to the `docs/`
folder
- Old docs go under `versioned-docs/version-old`
Doing this so that we can actually conform to docusaurus standards, and
therefore use their instructions on how to do things (like SEO
optimization for new docs vs old docs).
## NOTES FOR REVIEW
I didn't make many changes here except for:
1. moving old doc files to the `version-1.0`
2. Updating our langsmith cookbooks script we use to generate cookbooks
in the navbar
Brody