feat: migrate documentation to mintlify

[vabarbosa]

Which issue(s) does this pull-request address?

Closes: #675

Description

this PR migrates the current documentation to Mintlify

• .md files converted to .mdx updating syntax where necessary
• links reviewed & updated
• Python and TypeScript documentation combined
• Python and TypeScript code blocks moved into a tabbed code preview container
• update poe docs script accordingly

Checklist

General

• [ ] I have read the appropriate contributor guide: Python / TypeScript
• [ ] I have signed off on my commit: Python instructions / TypeScript instructions
• [ ] Commit messages and PR title follow conventional commits
• [ ] Appropriate label(s) added to PR: Python for Python changes, TypeScript for TypeScript changes

Code quality checks

• [ ] Linting passes: Python poe lint or poe lint --fix / TypeScript yarn lint or yarn lint:fix
• [ ] Formatting is applied: Python poe format or poe format --fix / TypeScript: yarn format or yarn format:fix
• [ ] Static type checks pass: Python poe type-check

Testing

• [ ] Unit tests pass: Python poe test --type unit / TypeScript yarn test:unit
• [ ] E2E tests pass: Python poe test --type e2e / TypeScript: yarn test:e2e
• [ ] Integration tests pass: Python poe test --type integration
• [ ] Tests are included (for bug fixes or new features)

Documentation

• [ ] Documentation is updated
• [ ] Embedme embeds code examples in docs. To update after edits, run: Python poe docs --type build

[planetf1]

#739 #740 #741 #742 are ready to merge into this docs/mintlify branch (before this is merged to main)

[planetf1]

We could merge this branch (I created a branch off it & rebased cleanly, it also has no broken links). However until this replaces the existing docs there's a risk of content divergence.

[Tomas2D]

I fixed the UI and script embedding.

[Tomas2D]

I merged changes from @markstur. Updated the integration guide, some links, and added the embedding section.

[markstur]

I merged changes from @markstur. Updated the integration guide, some links, and added the embedding section.

Looks great! Let's get this on main so we can maintain it with smaller updates.

[jenna-winkler]

Weeee! Nice job team 👏

[markstur]

🎉 Thanks, Tomas! So good to have this on main instead of a branch