Add documentation on how to get this GitHub action to work from scratch

[carlspring]

Task Description

It would be helpful to add some documentation on how to get this GitHub action to work from scratch. It may look straight-forward to someone who's done it a thousand times, but -- in reality -- it currently isn't.

For example, I am assuming that you need to create an application under Computer / Workers & Pages. However, this doesn't let you do so. If I select Create Application / Connect GitHub , it will ask me to approve some repository. I obviously am here, because I don't want this to be handled on Cloudflare's side, but -- rather -- via the GitHub Action. I also don't want it to create a "Hello, World!"-like application because that would deploy some demo app and I already have an mkdocs site which I'd like to publish.

So, like... some basic steps to get you set up before you can actually use this GitHub action, would be really helpful. Things like:

• How to create the application
• How to create the secrets / token properly
• How to secure the site with login credentials

Task Relationships

• Unable to create pages using github repository workers-sdk#9255

[vliggio]

Hi! I've drafted a getting started guide that addresses this issue — it walks through every step from zero:

1. Creating a Cloudflare API token with the right permissions
2. Finding your Account ID
3. Adding secrets to GitHub
4. Setting up a Workers or Pages project (including the case where you already have a static site like mkdocs and just want to deploy it — no need to create a project in the dashboard first)
5. Creating the GitHub Actions workflow
6. Common issues and fixes

The guide is in PR #421 on the docs/getting-started-guide branch. Maintainers — would appreciate a review to make sure the steps match the current dashboard flow and that the scope/location of the docs looks right. Happy to adjust based on feedback.