feat(examples): point live-voting source links at standalone repo

Add an optional `githubUrl` to example metadata so the "View on GitHub" button
can target a canonical home other than the docs repo, and set it for
pub-sub-live-voting to ably-demos/live-voting-with-annotations. Repoint the
README's clone/source links to the same standalone repo.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: SimonWoolf

examples/pub-sub-live-voting/javascript/README.md

@@ -41,7 +41,7 @@ modes, each scoped to the view that needs it.
 cannot publish poll messages, and cannot subscribe to other voters' raw
 annotations, so it can't tamper with the poll or snoop on individual votes. See
 the per-role capabilities in
-[`server/src/server.ts`](https://github.com/ably/docs/tree/main/examples/pub-sub-live-voting/javascript/server/src/server.ts).
+[`server/src/server.ts`](https://github.com/ably-demos/live-voting-with-annotations/blob/main/server/src/server.ts).
 
 **One vote per person, enforced by Ably.** Votes use the `unique` aggregation
 (`vote:unique.v1`). In this aggregation mode, Ably keeps at most one vote per
@@ -137,49 +137,21 @@ namespace before running this against your own app.
 
 ## Getting started
 
-The live demo above runs entirely in the browser. The full app — the
-voter/presenter/admin client plus the backend (`server/`), the poll data
-(`data/`) and the database schema (`database/`) — all lives under this
-`javascript/` folder, so "Open in CodeSandbox" gives you the whole project. To
-run it locally:
-
-1. Clone the [Ably docs](https://github.com/ably/docs) repository:
-
-   ```sh
-   git clone git@github.com:ably/docs.git
-   cd docs/examples/pub-sub-live-voting/javascript
-   ```
-
-2. Run the client. From the docs repo's `examples/` directory:
-
-   ```sh
-   yarn install
-   yarn pub-sub-live-voting-javascript  # Vite dev server on http://localhost:5173
-   ```
-
-   Vite proxies `/auth` and `/api` to the server on port 3000.
-
-3. Run the server (in a separate terminal). It's a standalone sub-project:
-
-   ```sh
-   cd examples/pub-sub-live-voting/javascript/server
-   cp .env.example .env   # set ABLY_API_KEY (keyName:keySecret) and ADMIN_PASSWORD
-   npm install
-   npm run dev            # auth + polls API on http://localhost:3000
-   ```
-
-   By default the server reads polls from the static `data/demo-shows.json` file
-   (`SHOWS_FILE`); to use Postgres instead, unset `SHOWS_FILE` and create the
-   schema with the SQL in `database/`.
-
-4. Open the client. The default view is the voter; add `?role=admin` to drive
-   the show and `?role=presenter` for the big screen. The admin generates a
-   session and a QR code that points voters at the right `?s=` session.
-
-In this clone the client never sees an API key — it calls the server's `/auth`
-endpoint for short-lived, role-scoped tokens. The hosted demo above has no
-backend, so it uses a raw key embedded in the page; this is just for demo
-purposes and should never be done in the real app.
+The live demo above runs entirely in the browser. For a complete app you can
+clone and run yourself — admin, voter and presenter, with proper token
+authentication and none of the in-page scaffolding — get
+[ably-demos/live-voting-with-annotations](https://github.com/ably-demos/live-voting-with-annotations).
+
+Its README has the full setup, but in short: give the server an Ably API key and
+an admin password, pick the static (`SHOWS_FILE`) or Postgres poll store, then
+run the server and the client. The default view is the voter; `?role=admin`
+drives the show and `?role=presenter` is the big screen, and the admin shows a QR
+code that points voters at the right session.
+
+The client never sees an API key — it calls the server's `/auth` endpoint for
+short-lived, role-scoped tokens. The hosted demo above has no backend, so it uses
+a raw key embedded in the page; that's just for the demo and should never be done
+in a real app.
 
 ## Related
 

src/data/examples/index.ts

@@ -256,6 +256,7 @@ export const examples: Example[] = [
     products: ['pubsub'],
     languages: ['javascript'],
     layout: 'double-horizontal',
+    githubUrl: 'https://github.com/ably-demos/live-voting-with-annotations',
     visibleFiles: [
       'src/script.ts',
       'src/shared/ably.ts',

src/data/examples/types.ts

@@ -10,6 +10,10 @@ export type Example = {
   visibleFiles?: string[];
   metaTitle?: string;
   metaDescription?: string;
+  // Override for the "View on GitHub" button. Defaults to this example's folder
+  // in the ably/docs repo; set it when the canonical source lives elsewhere
+  // (e.g. a standalone ably-demos repo).
+  githubUrl?: string;
 };
 
 export type ExampleWithContent = Example & {

src/templates/examples.tsx

@@ -171,7 +171,9 @@ const Examples = ({ pageContext }: { pageContext: { example: ExampleWithContent
             ) : null}
             <div className="flex flex-col gap-2 w-full md:w-[16.25rem] order-1 md:order-2 md:sticky md:top-20 self-start">
               <LinkButton
-                href={`https://github.com/ably/docs/tree/main/examples/${example.id}/${activeLanguage}`}
+                href={
+                  example.githubUrl ?? `https://github.com/ably/docs/tree/main/examples/${example.id}/${activeLanguage}`
+                }
                 target="_blank"
                 variant="secondary"
                 rightIcon="icon-social-github"