Sync source branch with deployed content structure

[sandervanhooft]

Problem

The source branch (main) has diverged from what's deployed on gh-pages. Content exists in gh-pages that was never added to the source, causing deploys to overwrite it.

Missing from source

• content/0.introduction.md - Welcome page
• content/3.packages/index.md - Packages overview
• content/3.packages/2.laravel/* - Laravel package docs (synced from vatly/vatly-laravel)
• content/4.integrations.md - Integrations page

Current state

• gh-pages: Manually restored to previous working version with all content
• main branch: Missing the above content
• SDK sync workflow: Only syncs PHP SDK, not Laravel

Tasks

• Extract missing content from gh-pages raw/ folder into source
• Restructure content folder to match deployed navigation:

  content/
    0.introduction.md
    1.guides/
    2.api-reference/
    3.packages/
      index.md (overview)
      1.php/
      2.laravel/
    4.integrations.md
  

• Add Laravel docs sync to workflow (pull from vatly/vatly-laravel/docs)
• Fix OpenAPI download link (use full URL or anchor tag)
• Update deploy workflow to build from main
• Test full build locally before deploying

Context

Incident 2026-02-27: SDK sync deploy overwrote gh-pages and lost Laravel docs + other content that only existed in gh-pages.

[sandervanhooft]

Resolved - all content now in source branch