Skip to content

Add Analog Workers guide and replace Pages guide with redirect page#26995

Merged
petebacondarwin merged 8 commits intoproductionfrom
devin/1765232332-analog-workers-guide
Jan 8, 2026
Merged

Add Analog Workers guide and replace Pages guide with redirect page#26995
petebacondarwin merged 8 commits intoproductionfrom
devin/1765232332-analog-workers-guide

Conversation

@petebacondarwin
Copy link
Copy Markdown
Contributor

@petebacondarwin petebacondarwin commented Dec 8, 2025

Summary

This PR migrates the Analog framework documentation from Cloudflare Pages to Cloudflare Workers, aligning with the changes in cloudflare/workers-sdk#11563 which updates the C3 Analog template to use the Workers platform instead of Pages.

Changes:

  • Added: New Analog Workers guide at workers/framework-guides/web-apps/more-web-frameworks/analog.mdx following the same pattern as other Workers framework guides (Angular, Nuxt)
  • Replaced: Old Analog Pages guide with a redirect/navigation page pointing to the Workers guide (similar to the Next.js pattern)
  • Removed: Analog from the Pages C3 guide's supported frameworks list (pages/get-started/c3.mdx)

The new guide is intentionally simpler than the old Pages guide because the Workers-based Analog template uses the standard Nitro cloudflare_module preset, which handles bindings natively without requiring custom dev bindings modules.

Updates since last revision

Per reviewer feedback, instead of fully removing the Pages guide, it has been replaced with a navigation page that redirects users to the Workers guide. This follows the same pattern used for Next.js, avoiding confusing gaps in the framework list.

Human review checklist

  • Confirm the C3 command --framework=analog (without --platform=pages) aligns with workers-sdk#11563
  • Check that the Nitro documentation link for bindings is appropriate
  • Verify the redirect page correctly points to the Workers guide URL
  • Confirm the redirect page pattern matches the Next.js approach

Documentation checklist


Link to Devin run: https://app.devin.ai/sessions/cb7c75b099e94315af5d37f6b1b2cf00
Requested by: @petebacondarwin

- Add new Analog Workers guide at workers/framework-guides/web-apps/more-web-frameworks/analog.mdx
- Remove deprecated Analog Pages guide (C3 no longer supports Analog on Pages)
- Add redirect from old Pages guide to new Workers guide

Co-Authored-By: pbacondarwin@cloudflare.com <pete@bacondarwin.com>
@devin-ai-integration
Copy link
Copy Markdown
Contributor

devin-ai-integration Bot commented Dec 8, 2025

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment and CI monitoring

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Dec 8, 2025

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/docs/pages/framework-guides/ @igorminar, @cloudflare/wrangler, @aninibread, @GregBrimble, @cloudflare/pcx-technical-writing
/src/content/docs/pages/ @cloudflare/workers-docs, @GregBrimble, @WalshyDev, @aninibread, @irvinebroque, @cloudflare/pcx-technical-writing
/src/content/docs/workers/ @cloudflare/workers-docs, @GregBrimble, @irvinebroque, @mikenomitch, @korinne, @WalshyDev, @cloudflare/deploy-config, @cloudflare/pcx-technical-writing, @cloudflare/wrangler, @cloudflare/workers-runtime-1, @mattietk

Co-Authored-By: pbacondarwin@cloudflare.com <pete@bacondarwin.com>
Co-Authored-By: pbacondarwin@cloudflare.com <pete@bacondarwin.com>
Copy link
Copy Markdown
Member

@MattieTK MattieTK left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks Pete!

devin-ai-integration Bot and others added 3 commits December 22, 2025 08:56
- Add new Analog Workers guide at workers/framework-guides/web-apps/more-web-frameworks/analog.mdx
- Remove deprecated Analog Pages guide (C3 no longer supports Analog on Pages)
- Add redirect from old Pages guide to new Workers guide

Co-Authored-By: pbacondarwin@cloudflare.com <pete@bacondarwin.com>
Co-Authored-By: pbacondarwin@cloudflare.com <pete@bacondarwin.com>
Co-Authored-By: pbacondarwin@cloudflare.com <pete@bacondarwin.com>
@petebacondarwin petebacondarwin force-pushed the devin/1765232332-analog-workers-guide branch from 7e351fa to 3842b7d Compare December 22, 2025 08:56
@petebacondarwin petebacondarwin requested a review from a team as a code owner December 22, 2025 08:56
@petebacondarwin petebacondarwin enabled auto-merge (squash) December 22, 2025 08:59
@ascorbic
Copy link
Copy Markdown
Contributor

Could the guide be replaced with something like the Next.js one that diverts people to use Workers instead? That way there won't be confusing gaps in the list, and people wanting to know how to deploy it will be able to find the correct approach.

@devin-ai-integration devin-ai-integration Bot changed the title Add Analog Workers guide and remove Pages guide Add Analog Workers guide and replace Pages guide with redirect page Dec 22, 2025
@devin-ai-integration
Copy link
Copy Markdown
Contributor

Thanks for the suggestion! I've added a redirect page similar to the Next.js pattern. The Pages guide now points users to the Workers guide instead of being fully removed.

Preview: https://devin-1765232332-analog-workers-guide.preview.developers.cloudflare.com/pages/framework-guides/deploy-an-analog-site/

@ascorbic
Copy link
Copy Markdown
Contributor

(aside) @petebacondarwin I forgot that Devin would just go ahead and implement my suggestion!

@petebacondarwin
Copy link
Copy Markdown
Contributor Author

Actually Devin had gone to sleep so I had to go and prompt it. But yeah, Devin did the work.

@petebacondarwin petebacondarwin merged commit f3c7d1d into production Jan 8, 2026
9 checks passed
@petebacondarwin petebacondarwin deleted the devin/1765232332-analog-workers-guide branch January 8, 2026 11:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

10 participants