DRAFT - Work in Process - Initial layout of new doc structure

[jpelletier1]

This is an initial layout that roughly mimics Devin docs. It attempts to separate Documentation and Use Cases.

Some background:

• The structure attempts to provide better onboarding docs and "first time user experience" docs.
  • This initial pass is mostly a mapping of existing content; there are some pages we may want to design
  • Features that are common across all interfaces (like Skills, MCP, Secrets, etc.) have their own standalone pages
• The OSS projects have some additional sections dedicated for them
  • Local GUI docs can be found under Documentation > Additional Docs > Local GUI
  • CLI docs also have their own section under Documentation > CLI
  • SDK remains its own tab, unchanged
• OpenHands Cloud can be found under Product Guides > OpenHands Cloud. There's more opportunity to build this out.

TODO:

• Pages marked TODO- are stubbed out but need more content

• Content is needed under the "Use Cases" tab

• Redesign the "Quick Start" page

• I have read and reviewed the documentation changes to the best of my ability.

• If the change is significant, I have run the documentation site locally and confirmed it renders as expected.

Summary of changes

[openhands-ai]

Looks like there are a few issues preventing this PR from being merged!

• GitHub Actions are failing:
  • Check Broken Links
  • .github/workflows/sync-agent-sdk-openapi.yml
  • .github/workflows/sync-docs-code-blocks.yml

If you'd like me to help, just leave a comment, like

@OpenHands please fix the failing actions on PR #284 at branch `jp/docs-restructure-0129`

Feel free to include any additional details that might help me get this PR into a better state.

_{^{You can manage your notification settings}}