docs: move README guidance to the official documentation website

.github/workflows/publish-cli.yml

@@ -16,9 +16,6 @@ on:
 permissions:
   contents: write
 
-env:
-  SCOPE_DOC_REPO: growth-ecosystems/scope-doc
-
 jobs:
   test:
     name: Build & Test CLI
@@ -64,10 +61,9 @@ jobs:
           echo "version=${NEW_VERSION}" >> "$GITHUB_OUTPUT"
 
       - name: Build CLI bundle
-        working-directory: apps/cli
         env:
           SCOPE_DEFAULT_API_URL: ${{ vars.SCOPE_API_URL }}
-        run: pnpm build
+        run: pnpm build:cli
 
       - name: Run integration tests
         run: pnpm vitest run --config vitest.integration.config.ts apps/cli/src/bundle.integration.test.ts
@@ -87,19 +83,8 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - name: Generate GitHub App token
-        id: app-token
-        uses: actions/create-github-app-token@v1
-        with:
-          app-id: ${{ secrets.FLUX_APP_ID }}
-          private-key: ${{ secrets.FLUX_APP_PRIVATE_KEY }}
-          owner: growth-ecosystems
-          repositories: scope-core,scope-doc
-
       - name: Checkout repository
         uses: actions/checkout@v4
-        with:
-          token: ${{ steps.app-token.outputs.token }}
 
       - name: Download bundle
         uses: actions/download-artifact@v4
@@ -116,18 +101,18 @@ jobs:
           git tag -a "cli/v${VERSION}" -m "CLI release v${VERSION}"
           git push origin "cli/v${VERSION}"
 
-      - name: Create release on scope-doc
+      - name: Create release
         env:
-          GH_TOKEN: ${{ steps.app-token.outputs.token }}
+          GH_TOKEN: ${{ github.token }}
           VERSION: ${{ needs.test.outputs.version }}
         run: |
           gh release create "cli/v${VERSION}" \
-            --repo "$SCOPE_DOC_REPO" \
+            --repo "$GITHUB_REPOSITORY" \
             --title "Scope CLI v${VERSION}" \
             --notes "## Installation
 
           \`\`\`bash
-          gh api repos/growth-ecosystems/scope-doc/contents/install-cli.sh -H \"Accept: application/vnd.github.raw\" | bash
+          gh api repos/${GITHUB_REPOSITORY}/contents/website/install-cli.sh -H \"Accept: application/vnd.github.raw\" | bash
           \`\`\`
 
           Or download \`scope.mjs\` from this release and place it in your PATH.

CONTRIBUTING.md

@@ -145,8 +145,10 @@ MongoDB is CosmosDB-compatible — avoid MongoDB features that CosmosDB's MongoD
   (`.agents/skills/rust-best-practices/SKILL.md`).
 - **Databases**: keep MongoDB usage CosmosDB-compatible (see migrations above).
 - **Documentation is not optional**: if you add or change a component, API, data model, pattern, or
-  deployment behavior, update the relevant doc in [`docs/`](./docs/) (or add one and link it from the
-  README) as the last step before opening your PR.
+  deployment behavior, update the relevant technical doc in [`docs/`](./docs/) and user-facing
+  guide in [`website/src/content/docs/`](./website/src/content/docs/) as appropriate. Add new
+  website pages to the sidebar in [`website/astro.config.mjs`](./website/astro.config.mjs)
+  as the last step before opening your PR.
 
 ## Submitting a pull request
 
@@ -222,6 +224,9 @@ installed dependencies.
 
 - Start with the [system architecture](./docs/architecture/system-architecture.md) and the
   [app design](./docs/architecture/app-design.md) docs for the big picture.
-- The [README](./README.md) introduces the platform, provides a local quick start, and links the full documentation index.
+- The [official documentation website](https://microsoft.github.io/scope/) includes
+  [local setup](https://microsoft.github.io/scope/getting-started/local-development/),
+  the [development guide](https://microsoft.github.io/scope/resources/development/), and
+  [contribution guidance](https://microsoft.github.io/scope/resources/contributing/).
 - Browse [open issues](https://github.com/microsoft/scope/issues) for bugs and
   proposed improvements. Discuss larger changes in an issue before starting work.